这是来自google的广告, 支持的朋友点一下,如果你不想被骚扰, 可单击此处关闭广告X

二. 功能及示例

1. 常规功能

  1. 支持多种调用模式

    除了支持常规在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/datePicker.gif" width="16" height="22" align="absmiddle">
    注意:只需要传入控件的id即可

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

    年月时分秒输入框都具备以下三种特性
    1. 通过导航图标选择


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


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


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

  3. 支持周显示

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


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


    <input id="d121" type="text" onclick="WdatePicker({isShowWeek:true})"/>

    注意:周算法参考的是ISO8601定义的方法,如果您对此有疑问,请详见:http://en.wikipedia.org/wiki/ISO_week_date

    周算法选择(4.8新增)
    相关属性:weekMethod
    周算法不同的地方有一些差异
    常见算法有两种
    1. ISO8601:规定第一个星期四为第一周,默认值
    2. MSExcel:1月1日所在的周

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

       您选择了第 (W格式)周, 另外您可以使用WW格式:
    <input type="text" class="Wdate" id="d122" onclick="WdatePicker({isShowWeek: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掉

    <input class="Wdate" type="text" id="d15" onclick="WdatePicker({isShowClear:false,readOnly:true})"/>

  6. 自动选择显示位置

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

  7. 自定义弹出位置

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


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

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

    <input class="Wdate" type="text" id="d16" onclick="WdatePicker({position:{left:100,top:50}})"/>

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

  8. 自定义星期的第一天(4.6新增)

    各个国家的习惯不同,有些喜欢以星期日作为第一天,有些以星期一作为第一天.
    相关属性:firstDayOfWeek: 可设置 0 - 6 的任意一个数字,0:星期日 1:星期一 以此类推

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


    <input class="Wdate" type="text" id="d17" onclick="WdatePicker({firstDayOfWeek:1})"/>

2. 特色功能

3. 多语言和自定义皮肤

4. 日期范围限制

5. 自定义事件

6. 快速选择功能

三. 配置说明

四. 如何使用