Wdatepicker CDN 使用指南

一、WdatePicker简介

WdatePicker是一个基于JavaScript的日期选择控件，由My97DatePicker发展而来，它提供了丰富的配置选项和灵活的API，可以满足各种日期选择需求。

二、引入方式

下载与解压

从官方网站或资源站点下载WdatePicker压缩包。

将压缩包解压到项目的某个目录中，例如/js/common/My97DatePicker/。

引入JS文件

在需要使用WdatePicker的页面中，通过<script>标签引入WdatePicker的主文件WdatePicker.js：

   <script type="text/javascript" src="${ctx}/WdatePicker/WdatePicker.js"></script>

三、基本用法示例

基础案例

   <input type="text" class="Wdate" onFocus="WdatePicker()"/>

如果WdatePicker.js中的属性$wdate=true，则在输入框中添加class="Wdate"，会在输入框右侧显示一个日期图标，如果不需要这个样式，可以去掉class="Wdate"或者修改皮肤目录下的WdatePicker.css文件。

限制日期范围

静态限制：通过设置minDate和maxDate属性来限制日期范围，限制日期范围为2006年9月10日至2008年12月20日：

     <input id="d411" class="Wdate" type="text" onfocus="WdatePicker({skin:'whyGreen',minDate: '2006-09-10', maxDate: '2008-12-20' })"/>

动态限制：使用系统提供的动态变量如%y（当前年）、%M（当前月）等来限制日期范围，只能选择今天以前的日期（包括今天）：

     <input id="d421" class="Wdate" type="text" onfocus="WdatePicker({skin:'whyGreen',maxDate: '%y-%M-%d' })"/>

自定义日期格式

可以通过设置dateFmt属性来自定义日期格式，只显示年份和月份：

   <input type="text" class="Wdate" id="d413" onclick="WdatePicker({dateFmt: 'yyyy年M月',minDate: '2008-2',maxDate: '2008-10'})"/>

高级用法

禁用某些日期：通过设置disabledDates属性来禁用特定日期，禁用所有早于2000年1月1日的日期：

     <input type="text" class="Wdate" onclick="WdatePicker({disabledDates:['^19']})"/>

自定义事件：通过设置onpicked、onclearing等事件来实现更复杂的逻辑控制，在选择日期后触发某个函数：

     <input type="text" class="Wdate" onpicked="myFunction()"/>

四、注意事项

确保引入的JS文件路径正确无误。

根据实际需求调整配置项和属性值。

对于复杂的逻辑控制，建议深入学习WdatePicker的官方文档和相关教程。

五、归纳

WdatePicker是一款功能强大的日期选择控件，通过简单的配置和灵活的API即可实现各种复杂的日期选择功能，本文介绍了WdatePicker的基本用法和一些常见的配置项，希望能对大家在使用WdatePicker时有所帮助。