ESUI - Select


List of Tables

1. 构造器静态参数配置
2. 初始化参数
3. 公共实例方法
4. 事件

1. 继承层级

Select - InputControl - Control

2. 说明

Select提供了建议的下拉列表的选择功能,是htmlform:select的模拟。

Select分成两个区域:主区域与浮动层区域。点击主区域会打开或关闭浮动层区域。浮动层打开时,点击页面其他任何地方,浮动层都会被关闭。

3. 构造器静态参数配置

Table 1. 构造器静态参数配置

名称描述
{string} EMPTY_TEXT当未选中任何项时,主区域显示的文字。

4. 初始化参数

Table 2. 初始化参数

名称描述
{Array} datasource选项列表。数据形式请参照E-JSON中的数据场景:键/值有序集合。
{boolean} disabled控件是否禁用。
{string} emptyText当未选中任何项时,主区域显示的文字。
{HTMLElement} main控件主元素。
{string|Object} rule验证规则。
{string} staticText当设置了此项,无论选中了任何项,主区域都只显示此设置的文字。
{number} selectedIndex当前选中的索引。如果初始化时包含value属性,则忽略该属性。
{string} value当前选中项的值。

5. 公共实例方法

Table 3. 公共实例方法

名称描述
{void} appendTo( {HTMLElement} wrap )将控件添加到页面的某个元素中。
{boolean} checkValidity( {void} )验证控件,仅返回true/false。
{void} disable( {void} )设置按钮状态为禁用。
{void} enable( {void} )设置按钮状态为启用。
{string} getValue( {void} )获取当前选中的值。
{boolean} isDisabled( {void} )获取按钮可用状态。
{void} render( {void} )绘制控件。
{void} setSelectedIndex( {number} index )根据索引选中项。
{void} setValue( {string} value )设置选中的值。
{boolean} validate( {void} )验证控件,当值不合法时显示错误信息。

6. 事件

Table 4. 事件

名称描述
{boolean} onchange: ( {string} value, {Object} item )当选中的项发生变化时触发。
{boolean} onmainclick: ( {void} )当主区域被点击时触发。
{void} onbeforevalidate( {validator.Validity} )验证开始前触发。
{void} onaftervalidate( {validator.Validity} )验证结束后触发。
{void} oninvalid( {validator.Validity} )验证控件值不合法时触发。