Skip to main content

remove()

Description​

Removes the specified item or all the items from the selection list when called without arguments

Usage​

remove({
id: string | number
}): boolean;

//or

remove(): boolean;

Parameters​

The method may take as an argument an object with the following parameter:

  • id - (required) the id of the item that should be removed from the selection list

Returns​

The method returns true if unselection of an item or the list cleanup has been successful

Example​

// a diagram must be created with the "select:true" option
const diagram = new dhx.Diagram("diagram_container", {
select: true
});
// loading data
diagram.data.parse(data);

console.log(diagram.selection.getIds()); // -> ["1", "2", "3"]
diagram.selection.remove({ id: "3" }); // -> returns true if the item has been unselected
console.log(diagram.selection.getIds()); // -> ["1", "2"]

When called without arguments, the method clears the selection list:

// a diagram must be created with the "select:true" option
const diagram = new dhx.Diagram("diagram_container", {
select: true
});
// loading data
diagram.data.parse(data);

console.log(diagram.selection.getIds()); // -> ["1", "2", "3"]
// removes all the items from the selection list
diagram.selection.remove();
console.log(diagram.selection.getIds()); // -> []

Change log: Updated in v6.0

Related articles:

Related sample: Diagram. Selection. Item selection