ESUI - 验证


Table of Contents

1. validator
1.1. namespace
1.2. 类
2. 验证规则类 - validator.Rule
2.1. 初始化参数
2.2. 公共实例方法
3. 不能为空验证规则类 - validator.RequiredRule
3.1. 继承层级
3.2. 初始化参数
3.3. 公共实例方法
4. 最大长度验证规则类 - validator.MaxLengthRule
4.1. 继承层级
4.2. 初始化参数
4.3. 公共实例方法
5. 最大值验证规则类 - validator.MaxValueRule
5.1. 继承层级
5.2. 初始化参数
5.3. 公共实例方法
6. 最小值验证规则类 - validator.MinValueRule
6.1. 继承层级
6.2. 初始化参数
6.3. 公共实例方法
7. 正则表达式验证规则类 - validator.PatternRule
7.1. 继承层级
7.2. 初始化参数
7.3. 公共实例方法
8. 验证信息类 - validator.Validity
8.1. 初始化参数
8.2. 公共实例方法
9. 规则验证状态类 - validator.ValidityState
9.1. 初始化参数
9.2. 公共实例方法

List of Tables

1.1.
2.1. 初始化参数
2.2. 公共实例方法
3.1. 初始化参数
3.2. 公共实例方法
4.1. 初始化参数
4.2. 公共实例方法
5.1. 初始化参数
5.2. 公共实例方法
6.1. 初始化参数
6.2. 公共实例方法
7.1. 初始化参数
7.2. 公共实例方法
8.1. 公共实例方法
9.1. 初始化参数
9.2. 公共实例方法

Chapter 1. validator

Table of Contents

1.1. namespace
1.2. 类

1.1. namespace

validator应置于顶层namespace下。如:ui.validator

1.2. 类

Table 1.1. 类

名称描述
validator.Rule默认验证规则类。
validator.RequiredRule不能为空验证规则类。对应快捷string为“required”
validator.MaxLengthRule最大长度验证规则类。对应快捷string为“maxlength”
validator.MaxValueRule最大值验证规则类。对应快捷string为“max”
validator.MinValueRule最小值验证规则类。对应快捷string为“min”
validator.PatternRule正则表达式验证规则类。对应快捷string为“pattern”
validator.Validity验证信息类。
validator.ValidityState规则验证状态类。

Chapter 2. 验证规则类 - validator.Rule

2.1. 初始化参数

Table 2.1. 初始化参数

名称描述
{string} name规则名称。该名称不可重复。
{Function} {number} check( {Control} control )验证函数,返回验证的状态码。0为合法,其余为错误码。
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

2.2. 公共实例方法

Table 2.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 3. 不能为空验证规则类 - validator.RequiredRule

3.1. 继承层级

validator.RequiredRule - validator.Rule

3.2. 初始化参数

Table 3.1. 初始化参数

名称描述
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

3.3. 公共实例方法

Table 3.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。恒返回“required”
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 4. 最大长度验证规则类 - validator.MaxLengthRule

4.1. 继承层级

validator.MaxLengthRule - validator.Rule

4.2. 初始化参数

Table 4.1. 初始化参数

名称描述
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

4.3. 公共实例方法

Table 4.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。恒返回“maxlength”
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 5. 最大值验证规则类 - validator.MaxValueRule

5.1. 继承层级

validator.MaxValueRule - validator.Rule

5.2. 初始化参数

Table 5.1. 初始化参数

名称描述
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

5.3. 公共实例方法

Table 5.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。恒返回“max”
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 6. 最小值验证规则类 - validator.MinValueRule

6.1. 继承层级

validator.MinValueRule - validator.Rule

6.2. 初始化参数

Table 6.1. 初始化参数

名称描述
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

6.3. 公共实例方法

Table 6.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。恒返回“min”
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 7. 正则表达式验证规则类 - validator.PatternRule

7.1. 继承层级

validator.PatternRule - validator.Rule

7.2. 初始化参数

Table 7.1. 初始化参数

名称描述
{string|Object} errorMessage错误信息。Object时通过错误码映射错误信息。支持${propName}语法取控件属性值。

7.3. 公共实例方法

Table 7.2. 公共实例方法

名称描述
{string} getName( {void} )获取验证器的名称。恒返回“pattern”
{validator.ValidityState} checkValidity( {Control} control )验证控件的验证状态。

Chapter 8. 验证信息类 - validator.Validity

8.1. 初始化参数

8.2. 公共实例方法

Table 8.1. 公共实例方法

名称描述
{void} addState( {string} name, {validator.ValidityState} state )添加验证状态。
{string} getCustomMessage( {void} )获取自定义验证信息。
{validator.ValidityState} getState( {string} name )获取验证状态。
{Array} getStateList( {void} )获取验证状态集合。
{boolean} isValid( {void} )获取整体是否验证通过。
{void} setCustomMessage( {string} message )设置自定义验证信息。

Chapter 9. 规则验证状态类 - validator.ValidityState

9.1. 初始化参数

Table 9.1. 初始化参数

名称描述
{string} message验证信息。
{boolean} state验证状态。

9.2. 公共实例方法

Table 9.2. 公共实例方法

名称描述
{string} getMessage( {void} )获取验证信息。
{boolean} getState( {void} )获取验证状态,true为值合法,false为值非法。
{void} setMessage( {string} message )设置验证信息。
{void} setState( {boolean} state )设置验证状态,true为值合法,false为值非法。