ESUI - Calendar


List of Tables

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

1. 继承层级

Calendar - InputControl - Control

2. 说明

日期类型的字符串格式为yyyy-MM-dd。

对于选中的日期,为Date类型的Javascript对象;对于可选择日期区间的数据格式,以一个Object表示。该Object拥有name为begin和end的属性,分别为Date类型。

{
    begin: new Date(1983, 8, 3),
    end: new Date(2011, 10, 4)
}

3. 构造器静态参数配置

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

名称描述
{string} DATE_FORMAT日期显示的格式化方式。
{Object} RANGE可选中的日期区间。

4. 初始化参数

Table 2. 初始化参数

名称描述
{string} dateFormat日期显示的格式化方式。
{boolean} disabled控件是否禁用。
{HTMLElement} main控件主元素。
{Object} range可选中的日期区间。
{string|Object} rule验证规则。
{string} value当前选中的日期。
{Date} valueAsDate当前选中的日期。

5. 公共实例方法

Table 3. 公共实例方法

名称描述
{void} appendTo( {HTMLElement} wrap )将控件添加到页面的某个元素中。
{boolean} checkValidity( {void} )验证控件,仅返回true/false。
{void} disable( {void} )设置控件状态为禁用。
{void} enable( {void} )设置控件状态为启用。
{string} getValue( {void} )获取当前选中的日期。
{Date} getValueAsDate( {void} )获取当前选中的日期。
{boolean} isDisabled( {void} )获取控件可用状态。
{void} render( {void} )绘制控件。
{void} setRange( {Object} range )设置允许选中的日期区间。
{void} setValue( {string} value )设置当前选中的日期。
{void} setValueAsDate( {Date} value )设置当前选中的日期。
{boolean} validate( {void} )验证控件,当值不合法时显示错误信息。

6. 事件

Table 4. 事件

名称描述
{boolean} onchange: ( {Date} value )当选择的日期发生改变时触发。
{void} onbeforevalidate( {validator.Validity} )验证开始前触发。
{void} onaftervalidate( {validator.Validity} )验证结束后触发。
{void} oninvalid( {validator.Validity} )验证控件值不合法时触发。