ESUI - TextInput


List of Tables

1. 初始化参数
2. 公共实例方法
3. 事件

1. 继承层级

TextInput - InputControl - Control

2. 说明

TextInput控件是一个输入表单,包括单行输入框或者多行输入框。输入框类型根据主元素的类型自动判断。

3. 初始化参数

Table 1. 初始化参数

名称描述
{boolean} disabled控件是否禁用。
{number} height输入框的高度。
{HTMLElement} main控件主元素。
{string} placeholder输入框值为空时的占位文字。
{string|Object} rule验证规则。
{string} value输入框的值。
{number} width输入框的宽度。

4. 公共实例方法

Table 2. 公共实例方法

名称描述
{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} select( {void} )获焦并选中文本。
{void} setValue( {string} value )设置输入框的值。
{void} setTitle( {string} title )设置输入框的title提示。
{boolean} validate( {void} )验证控件,当值不合法时显示错误信息。

5. 事件

Table 3. 事件

名称描述
{void} onenter: ( {void} )当在输入框内输入回车键时触发。
{void} onchange: ( {void} )当输入框的值发生改变时触发。
{void} onfocus: ( {void} )当输入框获得焦点时触发。
{void} onblur: ( {void} )当输入框失去焦点时触发。
{void} onbeforevalidate( {validator.Validity} )验证开始前触发。
{void} onaftervalidate( {validator.Validity} )验证结束后触发。
{void} oninvalid( {validator.Validity} )验证控件值不合法时触发。