gooflow设计器API说明书

花生米AJAX-UI系列之:

基于JQUERY的WEB在线流程图设计器GOOFLOW

0.4版

(2013-10-19)

[特点]

●跨浏览器，可兼容IE7--IE10，FireFox，Chrome，Opera等几大内核的浏览器，且不需要浏览器再加装任何控件。

●多系统兼容性、可移植性:由于只包括前台UI,因此二次开发者可很方便将本插件用在任何一种需要流程图的B/S系统应用上，流程图的详细实现逻辑完全交于后台程序开发者自己实现;对于后台,只要能返回/接收能被本插件解析的JSON格式数据即可.所以本插件可用于不同的服务器语言建立的后台上.

●跨领域:流程图设计器不止用在电信领域,在其它需要IT进行技术支持的领域中都有重大作用.

●

以下从纯技术实现层面具体描述:

●页面顶部栏、左边侧边栏均可自定义；

●当左边的侧边栏设为不显示时，为只读状态，此时的视图区可当作是一个查看器而非编辑器。

●侧边工具栏除了基本和一些流程节点按钮外，还自定义新的节点按钮，自定义节点都可以有自有的图标、类型名称，定义后在使用可可在工作区内增加这些自定义节点。

●顶部栏可显示流程图数据组的标题，也可提供一些常用操作按钮。

●顶部栏的按钮，除了撤销、重做按钮外，其余按钮均可自定义点击事件。

●可画直线、折线；折线还可以左右/上下移动其中段。

●具有区域划分功能，能让用户更直观地了解哪些节点及其相互间的转换，是属于何种自定义区域内的。

●具有标注功能，用橙红色标注某个结点或者转换线，一般用在展示流程进度时。

●能直接双击结点、连线、分组区域中的文字进行编辑

●在对结点、连线、分组区域的各种编辑操作，如新增/删除/修改名称/重设样式或大小/移动/标注时，均可捕捉到事件，并触发自定义事件，如果自定义事件执行的方法返回FALSE，则会阻止操作。

●具有操作事务序列控制功能，在工作区内的各种有效操作都能记录到一个栈中，然后可以进行撤销（undo()）或重做（redo()），像典型的C/S软件一样。

●0.4版中，加入了只导出在初始载入后被编辑的流程图中,只作了增删改等变更的元素，这样可用于用户快速存储，只保存本次变更过的内容，不用重新保存整个流程。

[一、GooFlow 设计器的界面]

如上图所示：工作区宽度高度均为可见区的2倍，X ，Y 轴的方向如图所示，于CSS 样式中顶距top 和左距left 是一样的； 左边是流程图绘制工具栏，从上至下依次为：选择指针、转换连接线、开始节点、结束节点、任务节点、自动节点、决策节点、状态节点、扩展附加节点、分支结点、聚合结点、复合子流程结点；最后一个不是节点，而是节点连线编辑与分组区域编辑两种工作区状态的切换开关，当切换至分组区域编辑后，只能操作分组区域块，节点与连线都被锁定；反之即然。

顶部是展示流程图标题和放置一些功能按钮的操作栏，这些按钮除了系统自带的外，还可由用户自定义。

如果初始化中设置不要左边工具栏和顶部的操作按钮，则该UI 就变成了一个流程图查看/跟踪器。 X Y

[二、GooFlow设计器的工作区元素]

开始节点、结束节点为圆形，复合节点是绿色，其余结点均是淡蓝色圆角矩形，双击节点中的文字，可直接进行编辑；

转换连线和直接和中段可上下移动的折线、中段可左右移动的折线共三种样式，双击线条可直接编辑线条的文字说明内容；

分组区域需要左下角的开关被按下后才可编辑，有四种随机颜色，点击左上角的圆形图标后可改变颜色，双击文本可直接编辑。

节点被选中时的样子:

连线被选中时的样子:

分组区域变为可操作时的样子:

[三、GooFlow类的构造函数]

function GooFlow(bgDiv,property){}

传参:

bgDiv：JQUERY对象，要渲染的DOM，必须含有ID。

Property是详细的初始化参数：{

width：UI的宽度;

height：UI的高度;

initNum：计算默认ID值的起始SEQUENCE,默认不填时为1;

haveHead：BOOL值,是否需要展示标题及顶部按钮的顶部栏;

initLabelText：初始化时标题的内容,默认不填时为newFlow_1;

haveTool：BOOL值,是否需要左边的工具栏(这决定了渲染完成后是编辑模式还是纯浏览模式)

useOperStack：BOOL值，决定了是否要用事务序列管理工作区内的操作事务，选TRUE的话，将开启正常使用撤销undo和重做redo的功能，该设定只在可编辑状态时有效。

toolBtns：一个数组，决定了左边的工具栏中，除了基本的结点/连线按钮图标外，还有哪些类型的结点；具体写法如：["task","node","chat","state","plug"]。数组中每个单元就是这些结点类型的名称，可用系统中已给的，也可自定义，但自定义一个类型name时,需要定义其CSS样式

类.ico_name。例如：

.ico_plug{background:url(img/gooflow_icon.png) no-repeat -135px -45px}

headBtns：字符串数组,决定了顶部栏的按钮从左至右依次都排了哪些类型的按钮,如:["new","open","save","undo","redo","reload"]；如果haveHead=false，则该定义无效。注意:除了这两个分别用来撤销操作，重做操作的按钮外，其余按钮点击时方法都需要自定义；数组中每个单元就是这些按钮的名称，可用系统中已给的"new","open","save","reload"，也可自定义，但自定义一个类型name时,需要定义其CSS样式类.ico_name。例如：

.GooFlow .ico_open{background:url(img/gooflow_icon.png) no-repeat -19px 1px} }

haveGroup：BOOL值，决定了是否有节点连线编辑与分组区域编辑两种工作区状态的切换开关。

[四、GooFlow对象的内部属性]

（注：以下加粗的内容均为使用该UI插件者最关心的部分，即组成流程图数据本身的部分！）