Безкоштовна JavaScript бібліотека для створення динамічних діаграм у стилі Visio

Бібліотека з відкритим кодом JavaScript для створення та відображення 2D векторної графіки та діаграм у стилі Visio. Підтримує блок‑схеми, організаційні діаграми, мережеві діаграми та інше.

Що таке бібліотека Draw2D?

У швидко мінливому світі веб-розробки здатність створювати динамічні, інтерактивні та візуально привабливі діаграми є справжньою революцією. Незалежно від того, чи ви створюєте редактор робочих процесів, інструмент для мережевих діаграм чи простий додаток для блок‑схем, вам потрібна потужна та гнучка бібліотека, яка втілить вашу ідею в життя. Зустрічайте Draw2D — відкриту JavaScript‑бібліотеку, яка дає змогу розробникам створювати малюнки та діаграми у стилі Visio з легкістю. Draw2D — це сучасна бібліотека HTML5 та JavaScript, призначена для створення динамічних діаграм, робочих процесів та візуальних мов безпосередньо в браузері. Випущена під ліцензією MIT, вона пропонує розробникам розширювану та інтерактивну платформу полотно.

Draw2D постачається з широким набором функцій, які роблять його провідним вибором для розробників. Він підтримує різноманітні вбудовані форми, з’єднання форм між собою, команди скасування та повтору, збільшення та зменшення, переміщення по полотну, прив’язку до сітки та багато іншого. Він надає багатий набір інструментів і компонентів для створення складних діаграм, таких як блок‑схеми, організаційні діаграми, мережеві діаграми тощо. Завдяки об’єктно‑орієнтованому API ви можете легко створювати власні форми, з’єднувачі та порти, а також керувати взаємодією користувачів, такою як перетягування, відпускання та зміна розмірів. Він поєднує простоту та потужність, пропонуючи розширені функції, такі як з’єднувачі, прив’язка до сітки та розширюваність SVG, підкріплені сильною документацією та живими демонстраціями.

Previous Next

Початок роботи з Draw2D

Рекомендований спосіб встановлення стабільної версії Draw2D — використання NPM. Будь ласка, використайте наступну команду для безпроблемної інсталяції.

Встановіть Draw2D через NPM

npm install
DIR=/examples yarn dev
// for new version
npm version patch
npm publish

Ви можете завантажити скомпільовану спільну бібліотеку з репозиторію GitHub.

Багатий набір підтримуваних форм

Відкрита бібліотека 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‑бібліотеки.

Як створювати з’єднувані форми у 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 можна зберегти в базі даних і пізніше використати для відтворення діаграми без втрат. Ось простий приклад, який показує, як зберегти та завантажити полотно за допомогою JavaScript‑бібліотеки.

Як зберігати та завантажувати полотно за допомогою JavaScript бібліотеки?

// 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» одразу після встановлення. Це важлива можливість для будь‑якого редактора, оскільки дозволяє користувачам легко виправляти помилки. Щоб увімкнути скасування та повтор, потрібно використовувати клас draw2d.command.CommandStack. Полотно має вбудований стек команд, до якого ви можете отримати доступ. Для великих діаграм важливо мати можливість збільшувати та зменшувати масштаб і переміщати полотно. Draw2D надає прості методи для керування рівнем масштабування та позицією полотна.

 Українська