提示
初始化引擎后，会生成一个 meta2d 全局对象，可直接使用。
调用meta2d前，需要确保meta2d所在的父容器element元素位置大小已经渲染完成。如果样式或css（特别是css动画）没有初始化完成，可能会报错（宽度为0）或影响显示。
划重点
所有js 语法均可打开 2D可视化编辑器 ，在浏览器控制台直接运行查看效果
如何学习
- 跟着“快速上手”文档做一遍，先有个总体认知
- 看一遍我们的视频教程，有个全面认识
- 多学习示例教程等
官方示例：https://github.com/le5le-com/meta2d.js/tree/main/examples
多找网上示例。找不到？你也可以多写学习心得，和大家一起交流学习。
- 多查阅Meta2d.js API
- 加入乐吾乐可视化交流群：
微信号：le5le-service，备注进交流群
在浏览器中体验
- 打开乐吾乐2D可视化编辑器
- F12打开浏览器控制台
- 在控制台输入
// 定义一个pen，矩形
const pen = {
name: "rectangle",
text: "矩形",
x: 100,
y: 100,
width: 100,
height: 100,
};
meta2d.addPen(pen);Copy
在 ES5 中使用
- 获取 meta2d.js
npm install meta2d.js --save - 拷贝 node_modules/meta2d.js/meta2d.js 到静态资源目录。比例 index.html 所在目录
- 编写 index.html
<!DOCTYPE html>
<html>
<head>
<title i18n>乐吾乐 Meta2d</title>
<meta charset="UTF-8" />
</head>
<body>
<div id="meta2d" style="height:100vh;width:100vw;"></div>
<script src="meta2d.js"></script>
<script src="index.js"></script>
</body>
</html> Copy
- 编写 index.js 加载 meta2d.js
var meta2d = new Meta2d("meta2d");
registerCommonDiagram(); //注册图形库
// Get the json data
// ...
// Open the json
meta2d.open(json); Copy
参考例子： https://github.com/le5le-com/meta2d.js/tree/master/examples/es5
在 Vue3 中使用
- 获取 @meta2d/core 等库
npm install @meta2d/core --save
// Option
npm install @meta2d/activity-diagram --save
npm install @meta2d/chart-diagram --save
npm install @meta2d/class-diagram --save
npm install @meta2d/flow-diagram --save
npm install @meta2d/fta-diagram --save
npm install @meta2d/form-diagram --save
npm install @meta2d/sequence-diagram --save
npm install @meta2d/le5le-charts --save
npm install @meta2d/svg --save - 编写 Vue
<template>
<div class="main">
<div id="meta2d"></div>
</div>
</template> Copy
- 编写 js 加载 meta2d
import { Options, Meta2d } from '@meta2d/core';
import { flowPens } from '@meta2d/flow-diagram';
import { activityDiagram } from '@meta2d/activity-diagram';
import { classPens } from '@meta2d/class-diagram';
import { sequencePens, sequencePensbyCtx } from '@meta2d/sequence-diagram';
import { defineComponent, onMounted, onUnmounted, ref } from 'vue';
import { formPens } from '@meta2d/form-diagram';
declare const window: any;
declare const meta2d: Meta2d;
export default defineComponent({
name: 'Meta2dCanvas',
components: {},
setup() {
const meta2dOptions: Options = {};
onMounted(() => {
new Meta2d('meta2d', meta2dOptions);
meta2d.register(flowPens());
meta2d.register(activityDiagram());
meta2d.register(classPens());
meta2d.register(sequencePens());
meta2d.registerCanvasDraw(sequencePensbyCtx());
meta2d.registerCanvasDraw(formPens());
// 监听消息事件
meta2d.on('contextmenu', contextmenu);
meta2d.on('click', click);
// 打开文件
meta2d.open(json);
});
onUnmounted(() => {
if (meta2d) {
meta2d.off('contextmenu', contextmenu);
meta2d.off('click', click);
meta2d.destroy();
}
});
const contextMenuVisible = ref(false);
function contextmenu() {
contextMenuVisible.value = true;
}
function click() {
contextMenuVisible.value = false;
}
return {
contextMenuVisible,
};
},
}); Copy
一个快速上手学习的示例
https://github.com/le5le-com/meta2d.js/tree/main/examples/diagram-editor-vue3
在 React 中使用
- 获取 @meta2d/core 等库
npm install @meta2d/core --save
// Option
npm install @meta2d/activity-diagram --save
npm install @meta2d/chart-diagram --save
npm install @meta2d/class-diagram --save
npm install @meta2d/flow-diagram --save
npm install @meta2d/fta-diagram --save
npm install @meta2d/form-diagram --save
npm install @meta2d/sequence-diagram --save
npm install @meta2d/le5le-charts --save
npm install @meta2d/svg --save - 编写 React jsx
import React, { useEffect } from "react";
import { Options, Meta2d } from "@meta2d/core";
import { flowPens } from "@meta2d/flow-diagram";
import { activityDiagram } from "@meta2d/activity-diagram";
import { classPens } from "@meta2d/class-diagram";
import { sequencePens, sequencePensbyCtx } from "@meta2d/sequence-diagram";
import { formPens } from "@meta2d/form-diagram";
const Meta2dContainer = () => {
useEffect(() => {
window.meta2d = new Meta2d("meta2d");
meta2d.register(flowPens());
meta2d.register(activityDiagram());
meta2d.register(classPens());
meta2d.register(sequencePens());
meta2d.registerCanvasDraw(sequencePensbyCtx());
meta2d.registerCanvasDraw(formPens());
// 打开文件
meta2d.open(json);
}, []);
return (
<div className="main">
<div className="meta2d" id="meta2d"></div>
</div>
);
};
export default Meta2dContainer; Copy
参考例子： https://github.com/le5le-com/meta2d.js/tree/master/examples/react