WdatePicker日曆控件使用方法

1. 跨無限級框架顯示

無論你把日期控件放在哪裏,你都不需要擔心會被外層的iframe所遮擋進而影響客戶體驗,因爲My97日期控件是可以跨無限級框架顯示的

示例2-7 跨無限級框架演示

可無限跨越框架iframe,無論怎麼嵌套框架都不必擔心了,即使有滾動條也不怕

2. 民國年日曆和其他特殊日曆

當年份格式設置爲yyy格式時,利用年份差量屬性yearOffset(默認值1911民國元年),可實現民國年日曆和其他特殊日曆

示例2-8 民國年演示

<input type="text" id="d28" onClick="WdatePicker({dateFmt:'yyy/MM/dd'})"/>

注意:年份格式設置成yyy時,真正的日期將會減去一個差量yearOffset(默認值爲:1911),如果是民國年使用默認值即可無需另外配置,如果是其他的差量,可以通過參數的形式配置

3. 爲編程帶來方便

如果el的值是this,可省略,即所有的el:this都可以不寫
日期框設置爲disabled時,禁止更改日期(不彈出選擇框)
如果沒有定義onpicked事件,自動觸發文本框的onchange事件
如果沒有定義oncleared事件,清空時,自動觸發onchange事件

4. 其他屬性

設置readOnly屬性,可指定日期框是否只讀
設置highLineWeekDay屬性,可指定是否高亮週末
設置isShowOthers屬性,可指定是否顯示其他月的日期
加上class="Wdate"就會在選擇框右邊出現日期圖標

多語言和自定義皮膚

1. 多語言支持

通過lang屬性,可以爲每個日期控件單獨配置語言,當然也可以通過WdatePicker.js配置全局的語言
語言列表和語言安裝說明詳見語言配置

示例3-1 多語言示例

繁體中文:
<input id="d311" class="Wdate" type="text" onFocus="WdatePicker({lang:'zh-tw'})"/>

英文:
<input id="d312" class="Wdate" type="text" onFocus="WdatePicker({lang:'en'})"/>

簡體中文:
<input id="d313" class="Wdate" type="text" onFocus="WdatePicker({lang:'zh-cn'})"/>

注意:默認情況lang='auto',即根據瀏覽器的語言自動選擇語言.

2. 自定義和動態切換皮膚

通過skin屬性,可以爲每個日期控件單獨配置皮膚,當然也可以通過WdatePicker.js配置全局的皮膚
皮膚列表和皮膚安裝說明詳見皮膚配置

示例3-2 皮膚演示

默認皮膚default: skin:'default'

<input id="d321" class="Wdate" type="text" οnfοcus="WdatePicker()"/>

注意:在WdatePicker裏配置了skin='default',所以此處可省略,同理,如果你把WdatePicker裏的skin配置成'whyGreen'那麼在不指定皮膚的情況下都使用'whyGreen'皮膚了

whyGreen皮膚: skin:'whyGreen'

4. 日期範圍限制

1. 靜態限制
注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致

你可以給通過配置minDate(最小日期),maxDate(最大日期)爲靜態日期值,來限定日期的範圍

示例4-1-1 限制日期的範圍是 2006-09-10到2008-12-20
<input id="d411" class="Wdate" type="text" οnfοcus="WdatePicker({skin:'whyGreen',minDate:'2006-09-10',maxDate:'2008-12-20'})"/>

示例4-1-2 限制日期的範圍是 2008-3-8 11:30:00 到 2008-3-10 20:59:30
<input type="text" class="Wdate" id="d412" οnfοcus="WdatePicker({skin:'whyGreen',dateFmt:'yyyy-MM-dd HH:mm:ss',minDate:'2008-03-08 11:30:00',maxDate:'2008-03-10 20:59:30'})" value="2008-03-09 11:00:00"/>

示例4-1-3 限制日期的範圍是 2008年2月到 2008年10月
<input type="text" class="Wdate" id="d413" οnfοcus="WdatePicker({dateFmt:'yyyy年M月',minDate:'2008-2',maxDate:'2008-10'})"/>

示例4-1-4 限制日期的範圍是 8:00:00 到 11:30:00
<input type="text" class="Wdate" id="d414" οnfοcus="WdatePicker({dateFmt:'H:mm:ss',minDate:'8:00:00',maxDate:'11:30:00'})"/>

2. 動態限制
注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致

你可以通過系統給出的動態變量,如%y(當前年),%M(當前月)等來限度日期範圍,你

還可以通過#{}進行表達式運算,如:#{%d+1}:表示明天

動態變量表

格式	說明
%y	當前年
%M	當前月
%d	當前日
%ld	本月最後一天
%H	當前時
%m	當前分
%s	當前秒
#{}	運算表達式,如:#{%d+1}:表示明天
#F{}	{}之間是函數可寫自定義JS代碼

示例4-2-1 只能選擇今天以前的日期(包括今天)
<input id="d421" class="Wdate" type="text" οnfοcus="WdatePicker({skin:'whyGreen',maxDate:'%y-%M-%d'})"/>

示例4-2-2 使用了運算表達式只能選擇今天以後的日期(不包括今天)
<input id="d422" class="Wdate" type="text" οnfοcus="WdatePicker({minDate:'%y-%M-#{%d+1}'})"/>

示例4-2-3 只能選擇本月的日期1號至本月最後一天
<input id="d423" class="Wdate" type="text" οnfοcus="WdatePicker({minDate:'%y-%M-01',maxDate:'%y-%M-%ld'})"/>

示例4-2-4 只能選擇今天7:00:00至明天21:00:00的日期
<input id="d424" class="Wdate" type="text" οnfοcus="WdatePicker({dateFmt:'yyyy-M-d H:mm:ss',minDate:'%y-%M-%d 7:00:00',maxDate:'%y-%M-#{%d+1} 21:00:00'})"/>

示例4-2-5 使用了運算表達式只能選擇 20小時前至 30小時後的日

期
<input id="d425" class="Wdate" type="text" onClick="WdatePicker({dateFmt:'yyyy-MM-dd HH:mm',minDate:'%y-%M-%d #{%H-20}:%m:%s',maxDate:'%y-%M-%d #{%H+30}:%m:%s'})"/>

3 . 腳本自定義限制
注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致

系統提供了$dp.$D和$dp.$DV這兩個API來輔助你進行日期運算,此外你還可以通過在 #F{} 中填入你自定義的腳本,做任何你想做的日期限制

示例4-3-1 前面的日期不能大於後面的日期且兩個日期都不能大於 2020-10-01

合同有效期從到
<input id="d4311" class="Wdate" type="text" onFocus="WdatePicker({maxDate:'#F{$dp.$D(\'d4312\')||\'2020-10-01\'}'})"/>
<input id="d4312" class="Wdate" type="text" onFocus="WdatePicker({minDate:'#F{$dp.$D(\'d4311\')}',maxDate:'2020-10-01'})"/>

注意:
兩個日期的日期格式必須相同

$dp.$ 相當於 document.getElementById 函數.
那麼爲什麼裏面的 ' 使用 \' 呢? 那是因爲 " 和 ' 都被外圍的函數使用了,故使用轉義符 \ ,否則會提示JS語法錯誤.
所以您在其他地方使用時注意把 \' 改成 " 或者 ' 來使用.

#F{$dp.$D(\'d4312\')||\'2020-10-01\'} 表示當 d4312 爲空時, 採用 2020-10-01 的值作爲最大值

示例4-3-2 前面的日期+3天不能大於後面的日期

日期從到
<input type="text" class="Wdate" id="d4321"

onFocus="WdatePicker({maxDate:'#F{$dp.$D(\'d4322\',{d:-3});}'})"/>
<input type="text" class="Wdate" id="d4322"

       onFocus="WdatePicker({minDate:'#F{$dp.$D(\'d4321\',{d:3});}'})"/>

       使用 $dp.$D 函數可以將日期框中的值,加上定義的日期差量:
       兩個參數: id={字符類型}需要處理的文本框的id值 , obj={對象類型}日期差量