g6/packages/site/docs/api/graphFunc/state.en.md

title	order
State of Item	7

graph.setItemState(item, state, enabled)

Set the item's state.

v3.4 and futher versions support multiple values for a state, refer to Take Use of State Mechanism.

This function will emit events beforitemstatechange and afteritemstatechange.

Parameters

Name	Type	Required	Description
item	string / Object	true	The id or the instance of the item.
state	string	true	The value of state. State can be comstomized as selected, hover, actived, and so on.
enabled	Boolean	true	Whether to activate the state.

Usage

// boolean values for state 'selected'
graph.setItemState('node1', 'selected', true);

// multiple values for state 'body'
graph.setItemState('node1', 'body', 'health');
graph.setItemState('node2', 'body', 'ill');

graph.clearItemStates(item, states)

Clear the states of the item. This function could clear multiple states in the same time.

Parameters

Name	Type	Required	Description
item	string / Object	true	The id or the instance of the item.
states	string / Array / null	false	It can be a single state value, an array, or null. When it is null, this operation will clear all state of the item.

Usage

// Clear single state 'a' of the node
graph.clearItemStates(node, 'a');

// Clear multiple states of the node
graph.clearItemStates(node, ['a', 'b']);

// Clear all the states of the node
graph.clearItemStates(node);

graph.priorityState(item, state)

Raise the priority of the specified state to the highest priority.

Parameters

Name	Type	Required	Description
item	string / Object	true	The id or the instance of the item.
states	string	true	state value

Usage

// Adjust the a state of node to the highest priority
graph.priorityState(node, 'a');