状态

show()

显示元素。

用法

  1. item.show();

hide()

隐藏元素。

用法

  1. item.hide();

changeVisibility(visible)

更改元素是否显示。

参数

名称类型是否必选描述
visiblebooleantrue是否显示元素,true为显示,false为隐藏

用法

  1. // 显示元素
  2. item.changeVisibility(true);
  3. // 隐藏元素
  4. item.changeVisibility(false);

isVisible()

查询元素显示状态。

返回值

  • 返回值类型:boolean;
  • 返回值为true,则表示当前元素处于显示状态,否则处于隐藏状态。

用法

  1. const visible = item.isVisible();

toFront()

将元素的层级设置到最上层,即当有元素重叠时,将元素置于顶层。。

用法

  1. item.toFront();

toBack()

将元素的层级设置到最下层,即当有元素重叠时,将元素置于底层。

用法

  1. item.toBack();

setState(state, enable)

更新元素的状态。

参数

名称类型是否必选描述
statestringtrue元素的状态,如selected、hover
enablebooleantrue是否启用状态的标识,为true表示启用该状态,否则不启用。

用法

  1. item.setState('selected', true);
  2. item.setState('actived', false);

clearStates(states)

清除指定的状态,如果不传states,则默认清除第一个状态。

参数

名称类型是否必选描述
statesstringarraytrue

用法

  1. // 清除selected状态
  2. item.clearStates('selected');
  3. // 清除active的、hover状态
  4. item.clearStates(['actived', 'hover']);

getStates()

获取当前元素的所有状态。

返回值

  • 返回值类型:array;
  • 返回当前元素的所有状态,是一个字符串数组,数组中值表示元素的状态。

用法

  1. // 获取元素的所有状态
  2. const states = item.getStates();

hasState(state)

判断元素是否具有某种指定的状态。

参数

名称类型是否必选描述
statestringtrue元素的状态

返回值

  • 返回值类型:boolean;
  • 返回值表示是否具有指定的状态,如果返回true,则说明元素有指定的状态,否则没有。

用法

  1. // 获取元素的所有状态
  2. const state = item.hasState('hover');