Biblioteca JavaScript Gratuita para Criar Diagramas Dinâmicos Semelhantes ao Visio

Biblioteca de diagramas Visio em JavaScript de código aberto para criar e exibir gráficos vetoriais 2D e diagramas semelhantes ao Visio. Suporta fluxogramas, organogramas, diagramas de rede e muito mais.

O que é a Biblioteca Draw2D?

No mundo em rápida mudança do desenvolvimento web, a capacidade de criar diagramas dinâmicos, interativos e visualmente atraentes é um divisor de águas. Seja construindo um editor de fluxo de trabalho, uma ferramenta de diagramas de rede ou um aplicativo simples de fluxograma, você precisa de uma biblioteca poderosa e flexível para dar vida à sua visão. Apresentamos o Draw2D, uma biblioteca JavaScript de código aberto que capacita desenvolvedores de software a criar desenhos e diagramas semelhantes ao Visio com facilidade. O Draw2D é uma biblioteca moderna, HTML5 e JavaScript projetada para criar diagramas dinâmicos, semelhantes ao Visio, fluxos de trabalho e linguagens visuais diretamente no navegador. Lançado sob a licença MIT, oferece aos desenvolvedores uma estrutura de canvas extensível e interativa.

Draw2D vem repleto de uma ampla variedade de recursos que o tornam uma escolha principal para desenvolvedores. Ele suporta diversos tipos de formas incorporadas, conexão de formas entre si, comandos de desfazer e refazer, zoom in e zoom out, movimentação pela tela, encaixe em grade e muito mais. Ele fornece um conjunto rico de ferramentas e componentes para construir diagramas complexos, como fluxogramas, organogramas, diagramas de rede e outros. Com sua API orientada a objetos, você pode criar facilmente formas personalizadas, conectores e portas, e gerenciar interações do usuário como arrastar, soltar e redimensionar. Ele equilibra simplicidade com poder, oferecendo recursos avançados como conectores, encaixe em grade e extensibilidade SVG, apoiado por documentação robusta e demonstrações ao vivo.

Previous Next

Começando com o Draw2D

A forma recomendada de instalar a versão estável do Draw2D é usando NPM. Por favor, use o comando a seguir para uma instalação tranquila.

Instale o Draw2D via NPM

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

Você pode baixar a biblioteca compartilhada compilada do repositório GiHhub.

Suporte a um Conjunto Rico de Formas

A biblioteca de código aberto Draw2D fornece uma variedade de formas incorporadas, incluindo retângulos, círculos, elipses, cubos e muitas outras. Desenvolvedores de software também podem criar formas personalizadas estendendo a classe draw2d.shape.basic.Rectangle ou outras classes de forma. O exemplo a seguir demonstra como os desenvolvedores podem criar um retângulo simples em aplicações JavaScript.

Como criar uma forma SVG personalizada via biblioteca JavaScript?

class MyCustomShape extends draw2d.SVGFigure {
  constructor() {
    super();
    this.svg = '';
  }
}
const shape = new MyCustomShape();
canvas.add(shape, 50, 50);

Sistema de Conexão Poderoso com Portas

Um dos recursos de destaque do Draw2D é seu sistema incorporado para criar formas conectáveis. As formas podem ter Portas (âncoras de entrada e saída), e os usuários (ou seu código) podem desenhar Conexões (linhas com setas opcionais) entre essas portas. A biblioteca gerencia o roteamento, arraste e a lógica de reconexão automaticamente. O exemplo a seguir demonstra a criação de formas conectáveis via biblioteca JavaScript.

Como criar formas conectáveis dentro da API JavaScript?

// 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

Serialização e Persistência (JSON)

Um recurso crucial para qualquer aplicação de diagramas é a capacidade de salvar e carregar o estado da tela. O Draw2D torna isso simples, permitindo exportar toda a tela, incluindo todas as formas e suas conexões, para um objeto JSON. Esse JSON pode ser salvo em um banco de dados e, posteriormente, usado para reconstruir o diagrama perfeitamente. Aqui está um exemplo simples que mostra como salvar e carregar uma tela via biblioteca JavaScript.

Como salvar e carregar um canvas via biblioteca 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);

Suporte a Desfazer/Refazer, Zoom e Pan

A biblioteca de código aberto Draw2D inclui uma pilha de comandos integrada que fornece funcionalidade de desfazer e refazer pronta para uso. Esse é um recurso crucial para qualquer editor, pois permite que os usuários corrijam erros facilmente. Para habilitar desfazer e refazer, você precisa usar a classe draw2d.command.CommandStack. A tela possui uma pilha de comandos incorporada que pode ser acessada. Para diagramas grandes, a capacidade de ampliar e reduzir o zoom e mover a tela é essencial. O Draw2D oferece métodos simples para controlar o nível de zoom e a posição da tela.

 Português