My97DatePicker控件使用说明.docx

示例1-1-1常规调用

示例1-1-2图标触发

'd12'}）"src="../skin/datePicker.gif"width="16"height="22"align="absmiddle">

注意:

只需要传入控件的id即可

2.下拉,输入,导航选择日期

年月时分秒输入框都具备以下三种特性

1.通过导航图标选择

2.直接使用键盘输入数字

3.直接从弹出的下拉框中选择

另:

年份输入框有智能提示功能,当用户连续点击同一个导航按钮5次时,会自动弹出年份下拉框

3.支持周显示

可以通过配置isShowWeek属性决定是否限制周,并且在返回日期的时候还可以通过自带的自定义事件和API函数返回选择的周

示例1-2-1周显示简单应用

true}）"/>

注意:

周算法参考的是ISO8601定义的方法,如果您对此有疑问,请详见:

http:

//en.wikipedia.org/wiki/ISO_week_date

周算法选择（4.7新增）

相关属性:

whichDayIsfirstWeek

周算法不同的地方有一些差异

常见算法有三种

1.ISO8601:

规定第一个星期四为第一周,默认值:

4

2.MSExcel:

1月1日所在的周:

可以填写:

7

3.自己根据需要自定义,每年的第一个星期X作为第一周,可以填写:

X（X可以是1-7之间任何一个数字）

示例1-2-2利用onpicked事件把周赋值给另外的文本框

  您选择了第

（W格式）周,另外您可以使用WW格式:

周

true,onpicked:

function（）{$dp.$（'d122_1'）.value=$dp.cal.getP（'W','W'）;$dp.$（'d122_2'）.value=$dp.cal.getP（'W','WW'）;}}）"/>

onpicked用法详见自定义事件

$dp.cal.getP用法详见内置函数和属性

4.只读开关,高亮周末功能

设置readOnly属性true或false可指定日期框是否只读

设置highLineWeekDay属性ture或false可指定是否高亮周末

5.操作按钮自定义

清空按钮和今天按钮,可以根据需要进行自定义,它们分别对应isShowClear和isShowToday默认值都是true

示例1-5禁用清空功能

最好把readOnly置为true,否则即使隐藏了清空按钮,用户依然可以在输入框里把值delete掉

false,readOnly:

true}）"/>

6.自动选择显示位置

当控件处在页面边界时,它会自动选择显示的位置,所以没有必要担心弹出框会被页面边界遮住的问题了.

7.自定义弹出位置

当控件处在页面边界时,它会自动选择显示的位置.此外你还可以使用position参数对弹出位置做调整.

示例1-6通过position属性,自定义弹出位置

使用positon属性指定,弹出日期的坐标为{left:

100,top:

50}

{left:

100,top:

50}}）"/>

position属性的详细用法详见属性表

8.自定义星期的第一天（4.6新增）

各个国家的习惯不同,有些喜欢以星期日作为第一天,有些以星期一作为第一天.

相关属性:

firstDayOfWeek:

可设置0-6的任意一个数字,0:

星期日1:

星期一以此类推

示例1-7以星期一作为第一天

1}）"/>

2.特色功能

1.平面显示

日期控件支持平面显示功能,只要设置一下eCont属性就可以把它当作日历来使用了,无需触发条件,直接显示在页面上

示例2-1平面显示演示