removing-删除

删除节点

Removing Connections

Removing Endpoints

Removing Nodes 删除节点

If you have configured a DOM element with jsPlumb in any way you should use jsPlumb to remove the element from the DOM (as opposed to using something like jQuery’s

remove

function, for example).

如果您通过jsPlumb方式已经配置了一个DOM元素，您应采用jsPlumb从DOM中删除该元素（而不是类似于jQuery中‘remove’等方法）

To help you with this, jsPlumb offers two methods:

为了帮助你达到删除节点的目的，jsPlumb提供了两种方法

jsPlumb.remove

This removes an element from the DOM and all Connections and Endpoints associate with that element:

该方法可从DOM中删除一个元素及其所有连接和端点关联的元素:

var conn = jsPlumb.connect({source:"element1", target:"element2"});
...
jsPlumb.remove("element1");

conn

is now detached and

element1

is gone from the DOM.

conn

现在已被断开，

element1

元素已从DOM中删除

You can also pass a selector or DOM element to the

remove

method.

jsPlumb.empty

This removes all the child elements from some element, and all of the Connections and Endpoints associated with those child elements. Perhaps you have this markup:

该功能可以清空某个元素下所有的子元素及其子素的所有的连接和端点。也许你需要在此标记一下:

<ul id="list">
<li id="one">One</li>
</ul>

var conn = jsPlumb.connect({source:"one", target:"someOtherElement"});
...
jsPlumb.empty("list");

conn

is now detached and the UL is empty.

conn

现在已断开并且UL已经清空。

You can also pass a selector or DOM element to the

empty

method.

Removing Connections/Endpoints 删除联线/端点

There are a number of different functions you can use to remove Connections and/or Endpoints.

在这里有许多不同的方法供你去删除联线和端点。

Connections

Detaching a single connection

To remove a single Connection, use

jsPlumb.detach

:

删除一个简单的联线，可以采用

jsPlumb.detach

:

var conn = jsPlumb.connect({ some params});
...
jsPlumb.detach(conn);

When you call

jsPlumb.detach

to remove a Connection, the Endpoints associated with that Connection may or may not also be deleted - it depends on the way the Connection was established. The Endpoints will be deleted under the following circumstances:

当你调用

jsPlumb.detach

删除某一联线时，与之相关的端点可能被删除也可能不被删除，这取决于联线建立的方式。以下情况端点将被删除：

you created the Connection using

jsPlumb.connect

and you did not set

deleteEndpointsOnDetach:false

.

当你使用

jsPlumb.connect

创建联线时，没有设置

deleteEndpointsOnDetach:false

.

the Connection was created via the mouse by a user on an element configured via

makeSource

which did not have

deleteEndpointsOnDetach:false

set.

当用户通过鼠标创建联线使用

makeSource

，相关元素没有

deleteEndpointsOnDetach:false

设置。

The Endpoints will not be deleted under the following circumstances:

you created the Connection using

jsPlumb.connect

and you set

deleteEndpointsOnDetach:false

the Connection was created via the mouse by a user from an Endpoint registered with

addEndpoint

.

the Connection was created via the mouse by a user on an element configured via

makeSource

which had

deleteEndpointsOnDetach:false

set.

Detaching all Connections from a single element

To detach all the Connections from some given element:

jsPlumb.detachAllConnections(el, [params])

el may be:

a String representing an element id

a DOM element

a selector representing a single element

params is optional and may contain:

fireEvent - whether or not to fire a disconnection event. The default is true.

Detaching all Connections from every element

To detach every Connection in jsPlumb:

jsPlumb.detachEveryConnection();

This leaves all Endpoints in place according to the deletion rules outlined in the description of

jsPlumb.detach

above.

Endpoints

Deleting a single Endpoint

To delete a single Endpoint:

var ep = jsPlumb.addEndpoint(someElement, { ... });
...
jsPlumb.deleteEndpoint(ep);

ep may be either:

a String, representing an Endpoint’s UUID (when you add an Endpoint you can provide a

uuid

member for that Endpoint)

an actual Endpoint object (as in the example above)

Deleting every Endpoint

To delete every Endpoint in jsPlumb:

jsPlumb.deleteEveryEndpoint();

This has the effect of removing every Endpoint and also every Connection.

Note this method is quite similar to

jsPlumb.reset

, except that this method does not remove any event handlers that have been registered.