一个可以通过拖放 SVG 图标,来生成拥有树状结构

SDT 是什么?

SDT 是 SVG Drag Tree 的缩写,一个可以通过拖放 SVG 图标,来生成拥有树形结构的视图与相应数据的前端组件。该组件不依赖任何其它库或框架,同时在样式上留给了用户极大的自由(因此,示例并不代表其最终样式),其 .min.js 格式文件大小约为 13kb。

示例戳: example SDT 做了哪些工作 自动获取元素的大小,你无须担心元素会叠加在一起 你可以设置元素之间怎样放置的从属关系 有直线与曲线两种连线方式可以选择,你可以自己设置连线的颜色 元素间的上下边距也是可设置的,但列与列之间的宽度则是自动的 目标画布的大小由外层 DIV 决定,同时你可以自定义背景 提供了两种设置方法:直接在HTML进行设置,或是在JS脚本中进行设置 如果不进行设置,则组件会提供一套默认规则 提供了整个目标画布的全局拖动与缩放,以及一个回到目标画布中心的方法 你可以撤销或删除任意元素,其余元素会重新排布 可以返回两种类型的数据:精简版与完整版。精简版只包涵了元素类型、ID、从属关系,减少向后台发送的数据量,但精简版数据不可用于重绘。完整版包涵了精简版所包涵的所有数据,同时也包涵了绘图相关信息,放置顺序相关信息,可以用作重绘 是的,提供了接收“完整版数据”然后进行重绘的方法(示例中刚打开网页就在画布中已经生成树形结构的方法) 返回一个可监测的值,当用户放置不符合你的设置时,改变为放置错误信息 SDT 的应用场景

目前已被应用在了某云服务商的虚拟设备编排上,其他的或许做个思维导图也还不错?

SDT 的优势 基于 SVG 所以相对于 Canvas 类库继承了 SVG 的一些优势,例如可以与 CSS 、DOM 协同工作 原生 js 无依赖,轻量 13kb 引入方法

通过 <script> 标签引入,若此标签放置于头部,则需为其添加并设置 defer="defer" 属性
注: 若通需过其他的 JS 脚本(如下面的 exampleScript.js)对组件进行设置或调用,则此 JS 文件需在 SDT.js 后引入

<head> ... <script src="SDT.js" defer="defer" type="text/javascript" charset="utf-8"></script> <script src="exampleScript.js" defer="defer" type="text/javascript" charset="utf-8"></script> ... </head>

在 .html 文件中,可拖动的所有 SVG 图标被一个 class = "sdt-drag-element-lis" 的 <div > 标签包围,每个SVG图标分别被一个 class="sdt-drag-element" 的 <div > 标签包围
注:class="sdt-drag-element" 的 <div> 标签必须拥有 data-sdt-type 属性,属性值为字符串,用以说明此图标的类型

<div class="sdt-drag-element-lis"> <div class="sdt-drag-element" data-sdt-type="icon-1"> <svg>...</svg> </div> <div class="sdt-drag-element" data-sdt-type="icon-2"> <svg>...</svg> </div> <div class="sdt-drag-element" data-sdt-type="icon-3"> <svg>...</svg> </div> ... </div>

在 .html 文件中,目标画布被一个 class="sdt-canvas" 的 <div> 标签包围,此标签的宽和高决定了目标画布的宽和高。目标画布本身是一个 id="sdt-drop-canvas" 的 <svg>标签

<div class="sdt-canvas"> <svg id="sdt-drop-canvas" width="100%" height="100%">...</svg> </div> 配置方法 不进行配置:

若不进行配置,则组件默认所有元素均可放置于所有元素之上,默认所有元素放置于右边树,元素间的上下边距为元素的高度,元素间的连线方式为贝塞尔曲线,连线颜色为#999,树的中心位于画布左上角

不进行配置示例戳: example 配置方法 1: 直接在 .html 文件中进行配置 元素配置:

在每个可拖动SVG图标外层的 <div>(class="sdt-drag-element") 标签中通过 data-sdt-eleset-* 进行元素配置

data-sdt-eleset-dropswitch 值为 true 或 false 当值为 true 时元素可直接放置于画布 data-sdt-eleset-leanright 值为 true 或 false 当值为 true 时元素默认放置于右侧树 data-sdt-eleset-foresidetype 值为一个字符串 type 间由 "," 隔开 当值为空时,则任何元素都将不接受其的放置;当值为 all 时所有元素都接受其放置;当值为合法 type 串时,type 串中所代表的类型元素将接受其放置

<div class="sdt-drag-element" data-sdt-type="icon-1" data-sdt-eleset-dropswitch=true data-sdt-eleset-leanright=true data-sdt-eleset-foresidetype="icon-1,icon-2"> <svg>...</svg> </div> 目标画布配置:

在 class="svg-canvas" 的 <div> 标签中通过 data-sdt-eleset-* 进行目标画布配置

data-sdt-eleset-lineType 值为 "straight" 或 "bessel" 当值为 "straight" 时元素间连线方式为直线;当值为 "bessel" 时元素间连线方式为贝塞尔曲线; data-sdt-eleset-lineColor 值为颜色色值字符串 连线颜色为此色值 data-sdt-eleset-treecenterX 值为数字(不带单位,非字符串) 树的中心 X 坐标 data-sdt-eleset-treecenterY 值为数字(不带单位,非字符串) 树的中心 Y 坐标 data-sdt-eleset-margin 值为数字(不带单位,非字符串) 元素的上下边距

<div class="svg-canvas" data-sdt-eleset-lineType="bessel" data-sdt-eleset-lineColor="#900" data-sdt-eleset-treecenterX="360" data-sdt-eleset-treecenterY="360" data-sdt-eleset-margin="8"> <svg id="dropCanvas" width="100%" height="100%">...</svg> </div> 配置方法 2: 在新的 JS 文件中进行配置

声明一个对象 set_o 对象字面量为

注意: SDTTreeElements 是数组对象,而 SDTTreeSet 是对象

var set_o = { "SDTTreeElements": [], "SDTTreeSet": {} }; 元素配置:

在 SDTTreeElements 数组中,每一项为一个对象,每个对象的:

type 属性 值为字符串 表示元素类型 dropswitch 属性 值为 true 或 false 当值为 true 时元素可直接放置于画布 leanRight 值为 true 或 false 当值为 true 时元素默认放置于右侧树 foresideType 值为一个数组 当数组为空时,则任何元素都将不接受其的放置;当数组有元素值为 all 时所有元素都接受其放置;当数组元素值为合法 type 时,其 type 所对应元素接受其放置

var set_o = { "SDTTreeElements": [ { "type": "icon-1", "dropSwitch": true, "foresideType": ["icon-1","icon-2"], "leanRight": false },{ "type": "icon-2", "dropSwitch": true, "foresideType": ["root", "icon-2"], "leanRight": false },{ "type": "icon-2", "dropSwitch": true, "foresideType": ["all"], "leanRight": false } ], "SDTTreeSet": {...} }; 目标画布配置:

在 SDTTreeSet 对象中,每一个属性:

lineType 值为 "straight" 或 "bessel" 当值为 "straight" 时元素间连线方式为直线;当值为 "bessel" 时元素间连线方式为贝塞尔曲线; lineColor 值为颜色色值字符串 连线颜色为此色值 treecenterX 值为数字(不带单位,非字符串) 树的中心 X 坐标 treecenterY 值为数字(不带单位,非字符串) 树的中心 Y 坐标 treeEleMargin 值为数字(不带单位,非字符串) 元素的上下边距

var set_o = { "SDTTreeElements": [...], "SDTTreeSet": { "lineType": "bessel", "lineColor": "#f00", "treeCenterX": "360", "treeCenterY": "360", "treeEleMargin": "16" } }; API SDT.SVGDragComponent()

对组件进行配置,接受一个参数,参数类型为对象,对象字面量应符合 “配置方法 2: 在新的 JS 文件中进行配置” 中所规定的格式

SDT.SVGDragComponent(set_o); SDT.backCenter()

返回画布中心,不接受参数

document.getElementById("btn-1").addEventListener("click", function () { SDT.backCenter(); }); SDT.removeELe()

删除元素,接受一个参数,参数类型为数组,数组元素应为要删除的元素的 id 注: 若不传入参数则删除最近放置的元素

document.getElementById("btn-2").addEventListener("click", function () { var rLis =["icon-2-3","icon-3-1","icon-1-1"] SDT.removeELe(rLis); }); document.getElementById("btn-3").addEventListener("click", function () { SDT.removeELe(); }); SDT.returnTree()

返回树,接受一个参数,参数类型为值为 true 或 false 的变量,若值为 true 则返回精简树(元素只包含 id 、 name 、 foresideObjId 、 childEles 信息),不可用于重绘;若值为 false 则返回完整树,完整树可用于重绘 注: 重绘要求有页面有图标信息,即相应的 class = "sdt-drag-element-lis" 的 <div> 标签所包涵的图标列表

var intTree = SDT.returnTree(true); SDT.drawInputTree()

重绘树,接受一个参数,参数类型为完整树 ,调用后会清空目标画布,并立即重绘

SDT.drawInputTree(intTree); SDT.dropErrorMsg

若放置不合法,其值会改变为最近拖放对象的 foresideType 信息,即可以放置在那些类型的元素后信息,可以通过 Object.defineProperty 监测值改变

Object.defineProperty(SDT.dropErrorMsg, 'dataDropError', { set: function (msg) { alert(msg); } }); 小目标 提高兼容性 代码重构,现在的代码写的太丑啦(字面量没抽取,函数过长,代码重复率高,if 嵌套) 加入单元测试 完善文档 为元素加入可自定义的信息属性与修改方法 为元素的 添加/删除 加入动画效果 小目标完成的差不多后,发布到 npm 已知 bug & 兼容性问题 IE 似乎全线挂吊了,Edge也挂了 Safari 拖动图标没效果,只能拖动文字部分

版权声明:

1、该文章(资料)来源于互联网公开信息,我方只是对该内容做点评,所分享的下载地址为原作者公开地址。
2、网站不提供资料下载,如需下载请到原作者页面进行下载。