jsPlumb插件做一个模仿viso的可拖拉流程图

前言

这是我第一次写博客，心情还是有点小小的激动！这次主要分享的是用jsPlumb，做一个可以给用户自定义拖拉的流程图，并且可以序列化保存在服务器端。

我在这次的实现上面做得比较粗糙，还有分享我在做jsPlumb流程图遇到的一些问题。

准备工作

制作流程图用到的相关的脚本：

 <script src="<%= ResolveUrl("~/resources/jquery/jquery-1.11..min.js")%>" type="text/javascript"></script>
     <script src="<%= ResolveUrl("~/resources/jquery-ui-1.10./js/jquery-ui-1.10..min.js") %>" type="text/javascript"></script>
     <script src="<%= ResolveUrl("~/resources/jquery-plugins/jquery.jsPlumb-1.6.-min.js") %>" type="text/javascript"></script>

jsPlumb-1.6.2-min.js在官网上下载，这里用得是最新版本。jquery-1.11.1.min.js等脚本百度上都能找到，这里就不多说了。

css样式在官网里也可以搜到，这里我就贴出来。

     .node {
             box-shadow: 2px 2px 19px #aaa;
             -o-box-shadow: 2px 2px 19px #aaa;
             -webkit-box-shadow: 2px 2px 19px #aaa;
             -moz-box-shadow: 2px 2px 19px #aaa;
             -moz-border-radius: 0.5em;
             border-radius: 0.5em;
             opacity: 0.8;
             filter: alpha(opacity=80);
             border: 1px solid #346789;
             width: 150px;
             /*line-height: 40px;*/
             text-align: center;
             z-index:;
             position: absolute;
             background-color: #eeeeef;
             color: black;
             padding: 10px;
             font-size: 9pt;
             cursor: pointer;
             height: 50px;
             line-height: 50px;
         }
         .radius {
             border-radius: 25em;
         }
         .node:hover {
             box-shadow: 2px 2px 19px #444;
             -o-box-shadow: 2px 2px 19px #444;
             -webkit-box-shadow: 2px 2px 19px #444;
             -moz-box-shadow: 2px 2px 19px #444;
             opacity: 0.8;
             filter: alpha(opacity=80);
         }

这里还有提到一点，jsPlumb官网上的api全是英文的，博主我从小英文就不好，所以看里面的doc非常费劲，一般都是一边开着金山翻译，

一边看着文档，英语好的略过这段。

正文

言归正传，现在开始我们的jsPlumb流程图制作，下面先附上流程图。

功能

根据客户的要求，我们要完成的功能点有以下几点：

1.支持将左边的div层复制拖拉到右边中间的层，并且左边同一个div拖拉没有次数限制，如果只能拖拉一次，做这个东西就没有什么意义了。

2.拖拉到中间的div层可以拖动，拖动不能超过中间div的边框。

3.拖动到中间的层，四周能有4个endpoint点，可供客户连线。

4.能支持删除多余的div的功能。

5.支持删除连接线。

6.能双击修改流程图的文字。

7.能序列化保存流程图。

操作

下面我们根据功能开始制作：

1.拖拉jsPlumb其实是提供draggable方法，和droppable方法官网里有介绍， 但是我这里用得是jquery里的draggable()和droppable()。

 <div id="left">
             <div class="node radius" id="node1">开始</div>
             <div class="node" id="node2">流程</div>
             <div class="node" id="node3">判断</div>
             <div class="node radius" id="node4">结束</div>
         </div>     

         <div id="right">
             <p>拖拉到此区域</p>
         </div>
         <div id="save">
             <input type="button" value="保存" onclick="save()" />
         </div>

     $("#left").children().draggable({
                 helper: "clone",
                 scope: "ss",
             });

helper:"clone"表示复制，scope:"ss"是一个标识为了判断是否可以放置，主要用于droppable方法里面也设置这个标识来判断拖放到的地方，

除非两个都不写scope，可以随便拖放，但是会有一个问题，每次我从左边拖东西到右边，我再拖到的时候就会有div拖到不了，所以最好设置

scope:"//里面的值随便,只是一个标识"。

下面是完整的拖放：

 $("#left").children().draggable({
                 helper: "clone",
                 scope: "ss",
             });
             $("#right").droppable({
                 scope: "ss",
                 drop: function (event, ui) {
                     var left = parseInt(ui.offset.left - $(this).offset().left);
                     var top = parseInt(ui.offset.top - $(this).offset().top);
                     var name = ui.draggable[0].id;
                     switch (name) {
                     case "node1":
                         i++;
                         var id = "state_start" + i;
                         $(this).append('<div class="node" style="border-radius: 25em"  id="' + id + '" >' + $(ui.helper).html() + '</div>');
                         $("#" + id).css("left", left).css("top", top);
                         jsPlumb.addEndpoint(id, { anchors: "TopCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "RightMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "BottomCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "LeftMiddle" }, hollowCircle);
                         jsPlumb.draggable(id);
                         $("#" + id).draggable({ containment: "parent" });
                         doubleclick("#" + id);
                         break;
                     case "node2":
                         i++;
                         id = "state_flow" + i;
                         $(this).append("<div class='node' id='" + id + "'>" + $(ui.helper).html() + "</div>");
                         $("#" + id).css("left", left).css("top", top);
                         jsPlumb.addEndpoint(id, { anchors: "TopCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "RightMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "BottomCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "LeftMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, hollowCircle);
                         jsPlumb.draggable(id);
                         $("#" + id).draggable({ containment: "parent" });
                         doubleclick("#" + id);
                         break;
                     case "node3":
                         i++;
                         id = "state_decide" + i;
                         $(this).append("<div class='node' id='" + id + "'>" + $(ui.helper).html() + "</div>");
                         $("#" + id).css("left", left).css("top", top);
                         jsPlumb.addEndpoint(id, { anchors: "TopCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "RightMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "BottomCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "LeftMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, hollowCircle);
                         jsPlumb.draggable(id);
                         $("#" + id).draggable({ containment: "parent" });
                         doubleclick("#" + id);
                         break;
                     case "node4":
                         i++;
                         id = "state_end" + i;
                         $(this).append('<div class="node" style="border-radius: 25em"  id="' + id + '" >' + $(ui.helper).html() + '</div>');
                         $("#" + id).css("left", left).css("top", top);
                         jsPlumb.addEndpoint(id, { anchors: "TopCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "RightMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "BottomCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "LeftMiddle" }, hollowCircle);
                         jsPlumb.draggable(id);
                         $("#" + id).draggable({ containment: "parent" });
                         doubleclick("#" + id);
                         break;
                     }
                 }
             });

怎么样把左边的层复制到右边的层，我的做法是这样的：

 $(this).append('<div class="node" style="border-radius: 25em"  id="' + id + '" >' + $(ui.helper).html() + '</div>');

做到这里会有人奇怪，怎么做到左边能拉无数次append到右边，id这样不会冲突吗？我就在外面var i=0; 当有元素拖放到右边的div时，i++;

然后var id="state_start"+i;拼接起来，这样你的id就不会一样了。

然后再设置div的left和top：

    drop: function (event, ui) {
                    var left = parseInt(ui.offset.left - $(this).offset().left);
                    var top = parseInt(ui.offset.top - $(this).offset().top);

    $("#" + id).css("left", left).css("top", top);

2.拖拉到中间的div层可以拖动，拖动不能超过中间div的边框：

jsPlumb.draggable(id);
$("#" + id).draggable({ containment: "parent" });

3.拖动到中间的层，四周能有4个endpoint点，可供客户连线:

这个功能是本文的重点，如何通过jsPlumb初始化端点和构造端点(endpoint)。

3.1 初始化端点样式设置：主要设置一些基本的端点，连接线的样式，里面的属性不设置，默认使用默认值

     //基本连接线样式
             var connectorPaintStyle = {
                 lineWidth: 4,
                 strokeStyle: "#61B7CF",
                 joinstyle: "round",
                 outlineColor: "white",
                 outlineWidth: 2
             };
             // 鼠标悬浮在连接线上的样式
             var connectorHoverStyle = {
                 lineWidth: 4,
                 strokeStyle: "#216477",
                 outlineWidth: 2,
                 outlineColor: "white"
             };
 var hollowCircle = {
                 endpoint: ["Dot", { radius: 8 }],  //端点的形状
                 connectorStyle: connectorPaintStyle,//连接线的颜色，大小样式
                 connectorHoverStyle: connectorHoverStyle,
                 paintStyle: {
                     strokeStyle: "#1e8151",
                     fillStyle: "transparent",
                     radius: 2,
                     lineWidth: 2
                 },        //端点的颜色样式
                 //anchor: "AutoDefault",
                 isSource: true,    //是否可以拖动（作为连线起点）
                 connector: ["Flowchart", { stub: [40, 60], gap: 10, cornerRadius: 5, alwaysRespectStubs: true }],  //连接线的样式种类有[Bezier],[Flowchart],[StateMachine ],[Straight ]
                 isTarget: true,    //是否可以放置（连线终点）
                 maxConnections: -1,    // 设置连接点最多可以连接几条线
                 connectorOverlays: [["Arrow", { width: 10, length: 10, location: 1 }]]
             };

3.2 构造端点(endpoint)：怎样将端点添加到div的四周？

     jsPlumb.addEndpoint(id, { anchors: "TopCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "RightMiddle" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "BottomCenter" }, hollowCircle);
                         jsPlumb.addEndpoint(id, { anchors: "LeftMiddle" }, hollowCircle);

通过jsPlumb.addEndpoint(a,b,c)里面有三个参数，a:要添加端点的div的id;b:设置端点放置的位置("TopCenter","RightMiddle","BottomCenter","LeftMiddle")

四个初始位置;c:端点和连接线的样式。b,c(可选).

添加多个端点:jsPlumb.addEndpoints(a,b,c)三个参数 c(可选)，a:要添加端点的div的id;b:含端点的构造函数参数的对象列表;

举个例子：

4.支持删除多余的div的功能:

有时候拖拉div经常会发生拖多了等问题，所有需要删除功能。我要做的删除效果是：鼠标放到div上面，div的右上角会出现一个红色的删除图标,鼠标移走就消失。如下图：

我是通过以下代码实现的：

         $("#right").on("mouseenter", ".node", function () {
                 $(this).append('<img src="../../resources/images/close2.png"  style="position: absolute;" />');
                 if ($(this).text() == "开始" || $(this).text() == "结束") {
                     $("img").css("left", 158).css("top", 0);
                 } else {
                     $("img").css("left", 158).css("top", -10);
                 }
             });
             $("#right").on("mouseleave", ".node", function () {
                 $("img").remove();
             });

我想在这里大家都有疑问吧，为什么用on()事件委托。因为<img />是后添加进来的元素，前面页面已经完成了初始化，所以你用$("img")根本找不到这个元素，

因为img是在页面初始化后，才添加的元素。这里就提到了live()为什么不用这个，jquery1.7.2才有这个方法，这里用的是jquery1.11.1 已经没有live()方法了，

取而代之的是on()方法。(live()有许多缺点，所以在新的版本被摒弃了)

后面删除比较简单：

     $("#right").on("click", "img",function () {
                 if (confirm("确定要删除吗?")) {
                     jsPlumb.removeAllEndpoints($(this).parent().attr("id"));
                     $(this).parent().remove();

                 }
             });

注明：这里我遇到一个问题，你删除了那个div,你还得把它周围的4个端点(endpoint)删除，这个问题刚开始我想了很多，一直没做出来，后来去jsPlumb官网查看相关的资料，

发现jsPlumb提供一个方法能删除div四周的端点。方法如下:

 jsPlumb.removeAllEndpoints($(this).parent().attr("id"));//删除指定id的所有端点

5.支持删除连接线:

     jsPlumb.bind("click", function (conn, originalEvent) {
                 if (confirm("确定删除吗？    "))
                     jsPlumb.detach(conn);
             });

6. 能双击修改流程图的文字：

     function doubleclick(id) {
             $(id).dblclick(function () {
                 var text = $(this).text();
                 $(this).html("");
                 $(this).append("<input type='text' value='" + text + "' />");
                 $(this).mouseleave(function () {
                     $(this).html($("input[type='text']").val());
                 });
             });
         }

7.能序列化保存流程图:

我的思路是这样的，将中间div里所有的"流程图div信息和连接线两端的信息"保存到数组里，然后序列化成json数据，通过ajax传到asp.net 后台，将json写入到txt文档里保存到服务器端。

（其实保存到数据库里是最好的，后面会考虑保存到数据库）,下次展示页面的时候，只要读取txt文档里的json，然后再转成泛型集合。

将页面上的div信息，和连线信息转成json跳转到ajax.aspx页面:

     function save() {
             var connects = [];
             $.each(jsPlumb.getAllConnections(), function (idx, connection) {
                 connects.push({
                     ConnectionId: connection.id,
                     PageSourceId: connection.sourceId,
                     PageTargetId: connection.targetId,
                     SourceText: connection.source.innerText,
                     TargetText: connection.target.innerText,
                 });
             });
             var blocks = [];
             $("#right .node").each(function (idx, elem) {
                 var $elem = $(elem);
                 blocks.push({
                     BlockId: $elem.attr('id'),
                     BlockContent: $elem.html(),
                     BlockX: parseInt($elem.css("left"), 10),
                     BlockY: parseInt($elem.css("top"), 10)
                 });
             });

             var serliza = JSON.stringify(connects) + "&" + JSON.stringify(blocks);
             $.ajax({
                 type: "post",
                 url: "ajax.aspx",
                 data: { id: serliza },
                 success: function (filePath) {
                     window.open("show-flowChart.aspx?path=" + filePath);
                 }
             });
         }

ajax.aspx页面将前台传过来的json保存到服务器端,并跳转至 show-flowChart.aspx:

   protected void Page_Load(object sender, EventArgs e)
     {
         if (!IsPostBack)
         {
             string str = Request["id"];
             string filePath = Server.MapPath("~/prototype/project-reply")+"\\json"+DateTime.Now.ToString("yyyyMMddhhmmss")+".txt";
               WriteToFile(filePath,str,false);
             //Response.Redirect("show-flowChart.aspx?path="+filePath);
             Response.Write(filePath);
         }
     }
     public static void WriteToFile(string name, string content, bool isCover)
     {
         FileStream fs = null;
         try
         {
             if (!isCover && File.Exists(name))
             {
                 fs = new FileStream(name, FileMode.Append, FileAccess.Write);
                 StreamWriter sw = new StreamWriter(fs, Encoding.UTF8);
                 sw.WriteLine(content);
                 sw.Flush();
                 sw.Close();
             }
             else
             {
                 File.WriteAllText(name, content, Encoding.UTF8);
             }
         }
         finally
         {
             if (fs != null)
             {
                 fs.Close();
             }
         }

     }

show-flowChart.aspx页面：

 protected void Page_Load(object sender, EventArgs e)
     {
         if (!IsPostBack)
         {
             string str = Request["path"];
             StreamReader sr = new StreamReader(str);
             string jsonText = sr.ReadToEnd();

             List<JsPlumbConnect> list = new JavaScriptSerializer().Deserialize<List<JsPlumbConnect>>(jsonText.Split('&')[]);
             List<JsPlumbBlock> blocks = new JavaScriptSerializer().Deserialize<List<JsPlumbBlock>>(jsonText.Split('&')[]);
             string htmlText = "";
             string conn = "";
             if (blocks.Count > )
             {
                 foreach (JsPlumbBlock block in blocks)
                 {
                     if(block.BlockContent=="开始"||block.BlockContent=="结束")
                         htmlText += "<div class='node radius' id='" + block.BlockId + "'style='left:"+block.BlockX+"px;top:"+block.BlockY+"px;' >" + block.BlockContent + "</div>";
                     else
                         htmlText += "<div class='node' id='" + block.BlockId + "'style='left:" + block.BlockX + "px;top:" + block.BlockY + "px;' >" + block.BlockContent + "</div>";
                 }
                 foreach (JsPlumbConnect jsplum in list)
                     conn += "jsPlumb.connect({ source: \"" + jsplum.PageSourceId + "\", target: \"" + jsplum.PageTargetId + "\" }, flowConnector);";
                 Literal1.Text = htmlText;
                 string script = "jsPlumb.ready(function () {" + conn + "});";
                 ClientScript.RegisterStartupScript(this.GetType(), "myscript", script, true);
             }
         }
     }

以及两个用到的类JsPlumbConnect类和JsPlumbBlock类:

 /// <summary>
     /// 连接线信息
     /// </summary>
     public class JsPlumbConnect
     {
         public string ConnectionId { get; set; }
         public string PageSourceId { get; set; }
         public string PageTargetId { get; set; }
         public string SourceText { get; set; }
         public string TargetText { get; set; }
     }
      /// <summary>
      /// 流程图的所有div
      /// </summary>
     public class JsPlumbBlock
     {
         /// <summary>
         /// div Id
         /// </summary>
          public string BlockId { get; set; }
         /// <summary>
         /// div里面的内容
         /// </summary>
          public string BlockContent { get; set; }
          public int BlockX { get; set; }
          public int BlockY { get; set; }
     }

结尾

转载请注明出处，谢谢！

附件下载地址：http://pan.baidu.com/s/1jGC8XM2