کتابخانه رایگان جاوااسکریپت برای ایجاد نمودارهای پویا شبیه Visio
کتابخانه منبع باز جاوااسکریپت برای نمودارسازی Visio جهت ایجاد و نمایش گرافیکهای برداری دو بعدی و نمودارهای شبیه Visio. این کتابخانه از فلوچارتها، نمودارهای سازمانی، نمودارهای شبکهای و موارد دیگر پشتیبانی میکند.
کتابخانه Draw2D چیست؟
در دنیای به سرعت در حال تغییر توسعه وب، توانایی ایجاد نمودارهای پویا، تعاملی و بصری جذاب یک تغییر اساسی است. چه در حال ساخت یک ویرایشگر جریان کار، یک ابزار نمودار شبکه، یا یک برنامه ساده فلوچارت باشید، به یک کتابخانه قدرتمند و انعطافپذیر نیاز دارید تا دیدگاه خود را به واقعیت تبدیل کنید. در اینجا Draw2D وارد میشود، یک کتابخانهٔ متن باز جاوااسکریپت که به توسعهدهندگان نرمافزار امکان میدهد به سادگی نمودارها و ترسیمات شبیه Visio ایجاد کنند. Draw2D یک کتابخانه مدرن HTML5 و جاوااسکریپت است که برای ایجاد نمودارهای پویا، شبیه Visio، جریانهای کاری و زبانهای بصری مستقیماً در مرورگر طراحی شده است. این کتابخانه تحت مجوز MIT منتشر شده و چارچوب بوم قابل گسترش و تعاملی را به توسعهدهندگان ارائه میدهد.
Draw2D با مجموعه گستردهای از ویژگیها ارائه میشود که آن را به گزینهای برتر برای توسعهدهندگان تبدیل میکند. این کتابخانه از انواع اشکال داخلی، اتصال اشکال به یکدیگر، دستورات بازگردانی و تکرار، بزرگنمایی و کوچکنمایی، جابجایی در بوم، چسباندن به شبکه و موارد بیشتر پشتیبانی میکند. این ابزار مجموعهای غنی از ابزارها و مؤلفهها را برای ساخت نمودارهای پیچیده مانند فلوچارتها، نمودارهای سازمانی، نمودارهای شبکهای و غیره فراهم میکند. با API شیءگرا، میتوانید به راحتی اشکال سفارشی، کانکتورها و پورتها را ایجاد کنید و تعاملات کاربری مانند کشیدن، رها کردن و تغییر اندازه را مدیریت کنید. این کتابخانه سادگی را با قدرت ترکیب میکند و ویژگیهای پیشرفتهای مانند کانکتورها، چسباندن به شبکه و قابلیت گسترش SVG را ارائه میدهد که با مستندات قوی و دموی زنده پشتیبانی میشود.
شروع کار با Draw2D
روش پیشنهادی برای نصب نسخه پایدار Draw2D استفاده از NPM است. لطفاً برای نصب روان، از فرمان زیر استفاده کنید.
نصب Draw2D از طریق NPM
npm install
DIR=/examples yarn dev
// for new version
npm version patch
npm publish
میتوانید کتابخانهٔ مشترک کامپایلشده را از مخزن GiHhub دانلود کنید.
پشتیبانی از مجموعهای غنی از اشکال
کتابخانه منبع باز Draw2D مجموعهای از اشکال از پیش تعریفشده را فراهم میکند، از جمله مستطیلها، دایرهها، بیضیها، مکعبها و بسیاری موارد دیگر. توسعهدهندگان نرمافزار همچنین میتوانند با گسترش کلاس draw2d.shape.basic.Rectangle یا سایر کلاسهای شکل، اشکال سفارشی ایجاد کنند. مثال زیر نشان میدهد که چگونه توسعهدهندگان میتوانند یک مستطیل ساده را در برنامههای JavaScript ایجاد کنند.
چگونه یک شکل SVG سفارشی را با استفاده از کتابخانه JavaScript ایجاد کنیم؟
class MyCustomShape extends draw2d.SVGFigure {
constructor() {
super();
this.svg = '';
}
}
const shape = new MyCustomShape();
canvas.add(shape, 50, 50);
سیستم اتصال قدرتمند با پورتها
یکی از ویژگیهای برجسته Draw2D، سیستم داخلی آن برای ایجاد اشکال قابل اتصال است. اشکال میتوانند پورت (لنگرهای ورودی و خروجی) داشته باشند و کاربران (یا کد شما) میتوانند بین این پورتها اتصالها (خطوط با پیکانهای اختیاری) رسم کنند. کتابخانه بهصورت خودکار مسیریابی، کشیدن و منطق اتصال مجدد را مدیریت میکند. مثال زیر ایجاد اشکال قابل اتصال را با استفاده از کتابخانه JavaScript نشان میدهد.
چگونه اشکال قابل اتصال را درون API جاوااسکریپت ایجاد کنیم؟
// Create two rectangles
var start = new draw2d.shape.basic.Rectangle({x:50, y:50, width:80, height:40});
var end = new draw2d.shape.basic.Rectangle({x:250, y:50, width:80, height:40});
// Add a "hybrid" port to each shape (can be both input and output)
start.createPort("hybrid");
end.createPort("hybrid");
// Add them to the canvas
canvas.add(start);
canvas.add(end);
// Create a connection with an arrow at the target end
var connection = new draw2d.Connection();
connection.setSource(start.getPort(0)); // Connect to the first port of 'start'
connection.setTarget(end.getPort(0)); // Connect to the first port of 'end'
canvas.add(connection); // Add the connection to the canvas
سریالسازی و پایداری (JSON)
یک ویژگی حیاتی برای هر برنامهٔ نمودارسازی، قابلیت ذخیره و بارگذاری وضعیت بوم است. Draw2D این کار را به سادگی انجام میدهد با این امکان که کل بوم، شامل تمام اشکال و ارتباطات آنها، را به یک شیء JSON صادر کنید. این JSON میتواند در یک پایگاه داده ذخیره شود و بعداً برای بازسازی دقیق نمودار استفاده شود. در اینجا یک مثال ساده آورده شده است که نشان میدهد چگونه میتوان بوم را با استفاده از کتابخانهٔ جاوااسکریپت ذخیره و بارگذاری کرد.
چگونه یک بوم را با استفاده از کتابخانه جاوااسکریپت ذخیره و بارگذاری کنیم؟
// Serialize the canvas to a JSON object
var jsonData = canvas.toJSON();
// You can now save this JSON string, e.g., using localStorage or an API call
localStorage.setItem("myDiagram", JSON.stringify(jsonData));
// To load the canvas from the saved JSON
var savedJson = JSON.parse(localStorage.getItem("myDiagram"));
canvas.fromJSON(savedJson);
پشتیبانی از بازگردانی/ازنو، زوم و پان
کتابخانهٔ منبع باز Draw2D شامل یک پشتهٔ دستوری داخلی است که بهصورت پیشفرض قابلیت undo و redo را فراهم میکند. این یک ویژگی حیاتی برای هر ویرایشگر است، زیرا به کاربران امکان میدهد بهراحتی اشتباهات را اصلاح کنند. برای فعالسازی undo و redo، باید از کلاس draw2d.command.CommandStack استفاده کنید. بوم یک پشتهٔ دستوری داخلی دارد که میتوانید به آن دسترسی پیدا کنید. برای نمودارهای بزرگ، توانایی زوم کردن به داخل و خارج و جابجایی بوم ضروری است. Draw2D روشهای سادهای برای کنترل سطح زوم و موقعیت بوم ارائه میدهد.