My97DatePicker控件使用说明.doc

一. 简介
1. 简介
目前的版本是:
2. 注意事项
My97DatePicker目录是一个整体,不可破坏里面的目录结构,也不可对里面的文件改名,可以改目录名
,不可删除
各目录及文件的用途:
配置文件,在调用的地方仅需使用该文件,可多个共存,
语言和皮肤配置文件,无需引入
日期库主文件,无需引入
临时页面文件,不可删除
目录lang 存放语言文件,你可以根据需要清理或添加语言文件
目录skin 存放皮肤的相关文件,你可以根据需要清理或添加皮肤文件包
:$wdate=true时,在input里加上class="Wdate"就会在选择框右边出现日期图标,如果您不喜欢这个样式,可以把class="Wdate"去掉,
3. 支持的浏览器
IE + , Firefox + , Chrome, Opera + , Safari +
 
注意:IE ,如果你在IE8上使用遇到问题,请与我取得联系,务必附上能再现你的问题的纯HTML代码包
二. 功能及示例
1. 常规功能
支持多种调用模式
除了支持常规在input单击或获得焦点调用外,还支持使用其他的元素如:<img><div>等触发WdatePicker函数来调用弹出日期框
除了支持常规在input单击或获得焦点调用外,还支持使用其他的元素如:<img><div>等触发WdatePicker函数来调用弹出日期框
示例1-1-1 常规调用
<input id="d11" type="text" onClick="WdatePicker()"/>
示例1-1-2 图标触发
<input id="d12" type="text"/>
<img onclick="WdatePicker({el:'d12'})" src="../skin/" width="16" height="22" align="absmiddle">
注意:只需要传入控件的id即可
下拉,输入,导航选择日期
年月时分秒输入框都具备以下三种特性
1. 通过导航图标选择
2. 直接使用键盘输入数字
3. 直接从弹出的下拉框中选择
另:年份输入框有智能提示功能,当用户连续点击同一个导航按钮5次时,会自动弹出年份下拉框
支持周显示
可以通过配置isShowWeek属性决定是否限制周,并且在返回日期的时候还可以通过自带的自定义事件和API函数返回选择的周
示例1-2-1 周显示简单应用
<input id="d121" type="text" onfocus="WdatePicker({isShowWeek:true})"/>
注意:周算法参考的是ISO8601定义的方法,如果您对此有疑问,请详见:http://en./wiki/ISO_week_date
周算法选择()
相关属性:
whichDayIsfirstWeek
周算法不同的地方有一些差异
常见算法有三种
1. ISO8601:规定第一个星期四为第一周,默认值: 4
2. MSExcel:1月1日所在的周: 可以填写: 7
3. 自己根据需要自定义,每年的第一个星期X作为第一周,可以填写: X (X可以是1-7之间任何一个数字)
示例1-2-2 利用onpicked事件把周赋值给另外的文本框
   您选择了第(W格式)周, 另外您可以使用WW格式: 周
<input type="text" class="Wdate" id="d122" onFocus="WdatePicker({isShowWeek:true,onpicked:function() {$dp.$('d122_1').value=$('W','W');$dp.$('d122_2').value=$('W','WW');}})"/>
onpicked 用法详见自定义事件
$ 用法详见内置函数和属性
只读开关,高亮周末功能
设置readOnly属性 true 或 false 可指定日期框是否只读
设置highLineWeekDay属性 ture 或 false 可指定是否高亮周末
操作按钮自定义
清空按钮和今天按钮,可以根据需要