Wdatepicker日期控件的使用指南
来源:互联网 发布:淘宝加入购物车没提醒 编辑:程序博客网 时间:2024/06/04 20:14
http://blog.csdn.net/wanglei19880622/article/details/8051322
http://www.cnblogs.com/weiqt/articles/2012169.html
一. 简介
1. 简介
目前的版本是:4.72
2. 注意事项
- My97DatePicker目录是一个整体,不可破坏里面的目录结构,也不可对里面的文件改名,可以改目录名
- My97DatePicker.htm是必须文件,不可删除
- 各目录及文件的用途:
WdatePicker.js 配置文件,在调用的地方仅需使用该文件,可多个共存,以xx_WdatePicker.js方式命名
config.js 语言和皮肤配置文件,无需引入
calendar.js 日期库主文件,无需引入
My97DatePicker.htm 临时页面文件,不可删除
目录lang 存放语言文件,你可以根据需要清理或添加语言文件
目录skin 存放皮肤的相关文件,你可以根据需要清理或添加皮肤文件包 - 当WdatePicker.js里的属性:$wdate=true时,在input里加上class="Wdate"就会在选择框右边出现日期图标,如果您不喜欢这个样式,可以把class="Wdate"去掉,另外也可以通过修改skin目录下的WdatePicker.css文件来修改样式
3. 支持的浏览器
IE 6.0+ , Firefox 2.0+ , Chrome, Opera 9.5+ , Safari 3.0+
注意:IE 8.0是完美支持的,如果你在IE8上使用遇到问题,请与我取得联系,务必附上能再现你的问题的纯HTML代码包
三. 配置说明
1. 属性配置
- 属性表
属性 类型 默认值 说明 静态属性:只能在WdatePicker.js中配置,一般情况下,不建议您修改静态属性的值$wdatebooltrue是否自动引入Wdate类 设置为true时,可直接在引入WdatePicker.js的页面里使用 class="Wdate"
Wdate可在skin目录下的WdatePicker.css文件中定义
建议使用默认值$dpPathstring''是否显示指定程序包的绝对位置,一般情况下为空即可(程序自动创建),该属性是为防止极其少数的情况下程序创建出错而设置的
设置方法:
如果,程序包所在http中的地址为 http://localhost/proName/My97DatePicker/
则 $dpPath = '/proName/My97DatePicker/';
建议使用默认值$crossFramebooltrue是否跨框架,一般设置为true即可,遇到跨域错误时可以将此功能关闭可配置属性:可以在WdatePicker方法是配置elElement 或 Stringnull指定一个控件或控件的ID,必须具有value或innerHTML属性(如input,textarea,span,div,p等标签都可以),用户存储日期显示值(也就是dateFmt格式化后的值)velElement 或 Stringnull指定一个控件或控件的ID,必须具有value属性(如input),用于存储真实值(也就是realDateFmt和realTimeFmt格式化后的值)doubleCalendarboolfalse是否是双月模式,如果该属性为true,则弹出同时显示2个月的日期框enableKeyboardbooltrue键盘控制开关enableInputMaskbooltrue文本框输入启用掩码开关autoUpdateOnChangedboolnull在修改年月日时分秒等元素时,自动更新到el,默认是关闭的(即:需要点击确定或点击日期才更新)
为false时 不自动更新
为true时 自动更新
为null时(默认值) 如果有日元素且不隐藏确定按钮时 为false,其他情况为truewhichDayIsfirstWeekint(1-7之间任何一个数字)4周算法不同的地方有一些差异
常见算法有三种
1. ISO8601:规定第一个星期四为第一周,默认值: 4
2. MSExcel:1月1日所在的周: 可以填写: 7
3. 自己根据需要自定义,每年的第一个星期X作为第一周,可以填写: X (X可以是1-7之间任何一个数字)
相关链接:http://en.wikipedia.org/wiki/ISO_week_datepositionobject{}日期选择框显示位置
注意:坐标默认单位是px,是相对当前框架坐标(不受滚动条),left属性只接受数字,top属性除接受数字外还可以接受 'above' 上方显示, 'under' 下方显示, 'auto' 系统根据页面大小自动选择(默认)
如:
{left:100,top:50}表示固定坐标[100,50]
{top:50}表示横坐标自动生成,纵坐标指定为 50
{left:100}表示纵坐标自动生成,横坐标指定为 100
{top:'above'}表示上方显示
{top:'under'}表示下方显示
请参考示例langstring'auto'当值为'auto'时 自动根据客户端浏览器的语言自动选择语言
当值为 其他 时 从langList中选择对应的语言
你可以参考语言配置skinstring'default'皮肤名称 默认自带 default和whyGreen两个皮肤
另外如果你的css够强的话,可以自己做皮肤
你可以参考皮肤配置dateFmtstring'yyyy-MM-dd'日期显示格式
你可以参考自定义格式realDateFmtstring'yyyy-MM-dd'计算机可识别的,真正的日期格式
无效日期设置(disabledDates),最大日期(maxDate),最小日期(minDate)以及快速日期都必须与它们相匹配
建议使用默认值realTimeFmtstring'HH:mm:ss'realFullFmtstring'%Date %Time'minDatestring'1900-01-01 00:00:00'最小日期(注意要与上面的real日期相匹配)maxDatestring'2099-12-31 23:59:59'最大日期(注意要与上面的real日期相匹配)startDatestring''起始日期,既点击日期框时显示的起始日期
为空时,使用今天作为起始日期(默认值)
否则使用传入的日期作为起始日期(注意要与上面的real日期相匹配)
你可以参考起始日期示例firstDayOfWeekint0周的第一天 0表示星期日 1表示星期一isShowWeekboolfalse是否显示周
你可以参考周显示示例highLineWeekDaybooltrue是否高亮显示 周六 周日isShowClearbooltrue是否显示清空按钮isShowTodaybooltrue是否显示今天按钮isShowOthersbooltrue为true时,第一行空白处显示上月的日期,末行空白处显示下月的日期,否则不显示readOnlyboolfalse是否只读errDealModeint0纠错模式设置 可设置3中模式 0 - 提示 1 - 自动纠错 2 - 标记autoPickDateboolnull为false时 点日期的时候不自动输入,而是要通过确定才能输入
为true时 即点击日期即可返回日期值
为null时(推荐使用) 如果有时间置为false 否则置为trueqsEnabledbooltrue是否启用快速选择功能autoShowQSboolfalse是否默认显示快速选择quickSelArraynull快速选择数据,可以传入5个快速选择日期
注意:日期格式必须与 realDateFmt realTimeFmt realFullFmt 相匹配
你可以参考快速选择示例disabledDaysArraynull可以使用此功能禁用周日至周六所对应的日期
0至6 分别代表 周日至周六
你可以参考无效天示例disabledDatesArraynull可以使用此功能禁用所指定的一个或多个日期
你可以参考无效日期示例oppositeboolfalse默认为false, 为true时,无效日期变成有效日期
注意:该属性对无效天特殊天不起作用
你可以参考有效日期示例specialDatesArraynull特殊日期,对指定的日期进行高亮显示
你可以参考特殊天与特殊日期示例specialDaysArraynull特殊天,使用此功能禁用周日至周六所对应的日期进行高亮显示
0至6 分别代表 周日至周六
你可以参考特殊天与特殊日期示例onpickingfunctionnull此四个参数为事件参数
你可以参考自定义事件示例onpickedfunctionnullonclearingfunctionnullonclearedfunctionnullychanging ychanged
Mchanging Mchanged
dchanging dchanged
Hchanging Hchanged
mchanging mchanged
schanging schangedfunctionnull(4.6Beta3新增)
y M d H m s 分别表示年月日时分秒
changing 事件发生在属性改变之前
changed 事件发生在属性改变之后
你可以参考示例5-4-1 - 配置全局默认值
通过配置WdatePicker.js的属性可以避免每次调用都传入配置值,为变成带来很多方便.
在默认情况下My97为每个属性都配置了默认值,这些默认值都可以在WdatePicker.js中修改的
你可以根据你个人的喜好更改这些值
比如你比较不喜欢默认的皮肤default 而更喜欢 whyGreen 这个皮肤,
你可以直接在WdatePicker.js把skin值改为 whyGreen
这样,你就不必每次调用控件的时候都传入 skin:'whyGreen' 了
你学会了吗? - 配置单个控件
在控件里面你可以使用 onfocus 或 onclick 事件来调用WdatePicker函数来触发日期控件
WdatePicker({})其中{}中的内容都是只对当前实例有效,你可以任意配置属性表里有的所有属性
你可以随意的组合这些属性,达到你的需求
My97日期控件在这方面是做得非常灵活的. - 多套配置快速切换
您可以设置多个WdatePicker.js文件,如 cn_WdatePicker.js,en_WdatePicker.js,simple_WdatePicker.js等
在不同的页面引入不同的 WdatePicker.js 达到配置快速切换的目的.
注意:文件必须以 _WdatePicker.js(大小写不限制) 为后缀,形如 <yourname>_WdatePicker.js
2. 语言配置
- 语言列表
My97DatePicker目录下有个config.js,里面有段代码:
var langList =
[
{name:'en',charset:'UTF-8'},
{name:'zh-cn', charset:'gb2312'},
{name:'zh-tw', charset:'GBK'}
];
这就是语言列表,每个项有name和charset两个属性.
name 表示语言的名称(必须与浏览器的语言字符串命名相同),在配置的时候,lang属性只能是配置列表里面已有的项,否则将自动返回第一项
charset 表示对应语言目录下的js文件所对应的编码格式 - 语言安装说明
分两步轻松实现:
1 将语言文件拷贝到 lang 目录
2 打开 config.js 配置语言列表
3. 皮肤配置
- 皮肤列表
My97DatePicker目录下有个config.js,里面有段代码:
var skinList =
[
{name:'default',charset:'gb2312'},
{name:'whyGreen', charset:'gb2312'},
{name:'blue', charset:'gb2312'},
{name:'simple', charset:'gb2312'}
];
这就是皮肤列表,每个项有name和charset两个属性.
name 表示皮肤的名称,在配置的时候,skin属性只能是配置列表里面已有的项,否则将自动返回第一项
charset 表示对应皮肤目录下的css文件:datepicker.css所对应的编码格式 - 皮肤安装说明
分两步轻松实现:
1 将皮肤文件包拷贝到 skin 目录
2 打开 config.js 配置皮肤列表
注意:安装过多的皮肤会影响性能,一般只安装自己使用的皮肤,3个以下比较适宜
四. 如何使用
1. 在使用该日期控件的文件中加入JS库(仅这一个文件即可,其他文件会自动引入,请勿删除或改名), 代码如下 <script language="javascript" type="text/javascript" src="datepicker/WdatePicker.js"></script>
注:src="datepicker/WdatePicker.js" 请根据你的实际情况改变路径
2. 加上主调函数 WdatePicker
关于 WdatePicker 的用法:
如果您是新手,对js还不是很了解的话一定要多看看这份文档
基本上每一个演示的示例下面都有相关代码,并且 关键属性用蓝字标出,关键值用红字标出 应该很容易看明白
如果您有一定的水准
希望能从头到尾把功能介绍好好看一遍,这样大部分功能你都会用了
如果您是高手
建议您通读配置说明和内置函数
五. 内置函数和属性
arg [object]: 日期差量,可以设置成
{y:[值],M:[值],d:[值],H:[值],m:[值],s:[值]}
属性 y,M,d,H,m,s 分别代表 年月日时分秒
{M:3,d:7} 表示 3个月零7天
{d:1,H:1} 表示1天多1小时将id对应的日期框中的日期字符串,加上定义的日期差量,返回使用real格式化后的日期串
参考 示例 4-3-2$dp.$DVString全局v [string]: 日期字符串
arg [object]: 同上例的arg将传入的日期字符串,加上定义的日期差量,返回使用real格式化后的日期串
参考 示例 4-3-3以下函数只在事件自定义函数中有效$dp.cal.getPString事件functionp [string]: 属性名称 yMdHmswWD分别代表年,月,日,时,分,秒,星期(0-6),周(1-52),星期(一-六)
f [string]: format 格式字符串
设置方法参考 1.4 自定义格式返回所指定属性被格式字符串格式化后的值[单属性],在changing,picking,clearing事件中返回选择前的值
参考 示例 1-2-2$dp.cal.getDateStrString事件functionf [string]: 格式字符串,为空时使用dateFmt
返回所指定属性被格式字符串格式化后的值[整个值],在changing,picking,clearing事件中返回选择前的值$dp.cal.getNewPString事件function用法同$dp.cal.getP返回所指定属性被格式字符串格式化后的值[单属性],在changing,picking,clearing事件中返回选择后的值$dp.cal.getNewDateStrString事件function用法同$dp.cal.getDateStr返回所指定属性被格式字符串格式化后的值[整个值],在changing,picking,clearing事件中返回选择后的值
$dp.cal.date.M:返回 月
$dp.cal.date.d:返回 日
$dp.cal.date.H:返回 时
$dp.cal.date.m:返回 分
$dp.cal.date.s:返回 秒
在changing,picking,clearing事件中返回选择前的日期对象$dp.cal.newdateobject事件function用法同$dp.cal.date在changing,picking,clearing事件中返回选择后的日期对象
六. 疑难解答
任何问题,请先参考 技术支持
如果找不到答案,您可以直接在blog留言,或者通过下面的联系方式与我联系
七. 联系My97
* 如果您在使用过程中遇到问题,或者有更好的建议
* 欢迎您访问
* BLOG: http://my97.cnblogs.com
* MAIL: support$my97.net($换成@)
* 有问题在我blog留言或给我Email吧,最好先仔细看说明,很多问题都是因为没有仔细看说明导致的
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- Wdatepicker日期控件的使用指南
- J2EE系列:Wdatepicker日期控件的使用指南
- WdatePicker日期控件的时间限制
- jquery日期控件WdatePicker的使用
- 日期控件--WdatePicker的使用小技能
- 说的什么好呢
- linux基础 --- shell编程
- Ambari配置&安装的若干坑
- memcpy函数的用法
- 迷宫寻宝(一)
- Wdatepicker日期控件的使用指南
- android教程学习 第12讲:lookup_keyword这个函数的实现
- 微信公众平台开发初探(一)WeiPHP与它调用插件的过程
- EAS BOS隐藏分录右上角的按钮
- 法非正义
- CentOS 7网络配置
- 解决UnicodeEncodeError: 'ascii' codec can't encode characters in position问题
- ARC EM处理器嵌入式系统开发与编程——互动出版网
- 文本框输入的样式