3.asp.htm 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
  5. <meta name="author" content="My97" />
  6. <meta name="keywords" content="日期控件 datepicker calendar 日历控件 javascript js日历控件 带时间 自定义格式 月历控件 日期时间 日期选择" /><title>My97日期控件 功能演示 配置说明 My97 Datepicker Demo</title>
  7. <link href="../../css/base.css" tppabs="http://www.my97.net/dp/css/base.css" rel="stylesheet" type="text/css" />
  8. <link href="demo.css" tppabs="http://www.my97.net/dp/demo/resource/demo.css" rel="stylesheet" type="text/css" />
  9. </head>
  10. <body>
  11. <iframe src="../../head.asp" tppabs="http://www.my97.net/dp/head.asp" scrolling="no" frameborder="0" height="100px" width="100%"></iframe>
  12. <script language="JavaScript" type="text/javascript" src="../../../WdatePicker.js" tppabs="http://www.my97.net/dp/My97DatePicker/WdatePicker.js"></script>
  13. <div class="dCenter dBody">
  14. <div id="content">
  15. <h2>三. 配置说明<a name="m3" id="m3"></a></h2>
  16. <h3>1. 属性配置<a name="m31" id="m31"></a></h3>
  17. <ol>
  18. <li>属性表<a name="m311" id="m311"></a>
  19. <table width="100%" border="0" cellpadding="3" cellspacing="1" bgcolor="#000000">
  20. <tr>
  21. <th>属性</th>
  22. <th>类型</th>
  23. <th>默认值</th>
  24. <th>说明</th>
  25. </tr>
  26. <tr>
  27. <td colspan="4">静态属性:只能在WdatePicker.js中配置,一般情况下,不建议您修改静态属性的值</td>
  28. </tr>
  29. <tr>
  30. <td align="center">$wdate</td>
  31. <td align="center">bool</td>
  32. <td align="center">true</td>
  33. <td>是否自动引入Wdate类 设置为true时,可直接在引入WdatePicker.js的页面里使用 class=&quot;Wdate&quot; <br />
  34. Wdate可在skin目录下的WdatePicker.css文件中定义<br />
  35. <span class="STYLE2">建议使用默认值</span></td>
  36. </tr>
  37. <tr>
  38. <td align="center">$dpPath</td>
  39. <td align="center">string</td>
  40. <td align="center">''</td>
  41. <td>是否显示指定程序包的绝对位置,一般情况下为空即可(程序自动创建),该属性是为防止极其少数的情况下程序创建出错而设置的<br />
  42. 设置方法:<br />
  43. 如果,程序包所在http中的地址为 http://localhost/proName/My97DatePicker/<br />
  44. 则 $dpPath = '/proName/My97DatePicker/';<br />
  45. <span class="STYLE2">建议使用默认值</span></td>
  46. </tr>
  47. <tr>
  48. <td align="center">$crossFrame</td>
  49. <td align="center">bool</td>
  50. <td align="center">true</td>
  51. <td>是否跨框架,一般设置为true即可,遇到跨域错误时可以将此功能关闭</td>
  52. </tr>
  53. <tr>
  54. <td colspan="4">可配置属性:可以在WdatePicker方法是配置</td>
  55. </tr>
  56. <tr>
  57. <td align="center">el</td>
  58. <td align="center">Element 或 String</td>
  59. <td align="center">null</td>
  60. <td>指定一个控件或控件的ID,必须具有value或innerHTML属性(如input,textarea,span,div,p等标签都可以),用户存储日期显示值(也就是dateFmt格式化后的值)</td>
  61. </tr>
  62. <tr>
  63. <td align="center">vel</td>
  64. <td align="center">Element 或 String</td>
  65. <td align="center">null</td>
  66. <td>指定一个控件或控件的ID,必须具有value属性(如input),用于存储真实值(也就是realDateFmt和realTimeFmt格式化后的值)</td>
  67. </tr>
  68. <tr>
  69. <td align="center">doubleCalendar</td>
  70. <td align="center">bool</td>
  71. <td align="center">false</td>
  72. <td>是否是双月模式,如果该属性为true,则弹出同时显示2个月的日期框</td>
  73. </tr>
  74. <tr>
  75. <td align="center">enableKeyboard</td>
  76. <td align="center">bool</td>
  77. <td align="center">true</td>
  78. <td>键盘控制开关</td>
  79. </tr>
  80. <tr>
  81. <td align="center">enableInputMask</td>
  82. <td align="center">bool</td>
  83. <td align="center">true</td>
  84. <td>文本框输入启用掩码开关</td>
  85. </tr>
  86. <tr>
  87. <td align="center">autoUpdateOnChanged</td>
  88. <td align="center">bool</td>
  89. <td align="center">null</td>
  90. <td>在修改年月日时分秒等元素时,自动更新到el,默认是关闭的(即:需要点击确定或点击日期才更新)<br />
  91. 为false时 不自动更新<br />
  92. 为true时 自动更新<br />
  93. 为null时(默认值) 如果有日元素且不隐藏确定按钮时 为false,其他情况为true</td>
  94. </tr>
  95. <tr>
  96. <td align="center">weekMethod</td>
  97. <td align="center">string</td>
  98. <td align="center">ISO8601</td>
  99. <td>周算法不同的地方有一些差异<br />
  100. 常见算法有两种<br />
  101. 1. ISO8601:规定第一个星期四为第一周,默认值<br />
  102. 2. MSExcel:1月1日所在的周<br />
  103. <br />
  104. 相关链接:<a href="javascript:if(confirm('http://en.wikipedia.org/wiki/ISO_week_date \n\n该文件未被 Teleport Pro 下载,因为 它位于起始地址以设置的边界以外的域或路径中。 \n\n你想要从服务器打开它吗?'))window.location='http://en.wikipedia.org/wiki/ISO_week_date'" tppabs="http://en.wikipedia.org/wiki/ISO_week_date" target="_blank">http://en.wikipedia.org/wiki/ISO_week_date</a></td>
  105. </tr>
  106. <tr>
  107. <td align="center">position</td>
  108. <td align="center">object</td>
  109. <td align="center">{}</td>
  110. <td> 日期选择框显示位置<br />
  111. <span class="STYLE2">注意:坐标单位是px,是相对当前框架坐标(不受滚动条影响),默认情况下系统根据页面大小自动选择</span><br />
  112. 如:<br />
  113. {left:100,top:50}表示固定坐标[100,50]<br />
  114. {top:50}表示横坐标自动生成,纵坐标指定为 50<br />
  115. {left:100}表示纵坐标自动生成,横坐标指定为 100<br />
  116. 请参考示例</td>
  117. </tr>
  118. <tr>
  119. <td align="center">lang</td>
  120. <td align="center">string</td>
  121. <td align="center">'auto'</td>
  122. <td>当值为'auto'时 自动根据客户端浏览器的语言自动选择语言<br />
  123. 当值为 其他 时 从langList中选择对应的语言 <br />
  124. 你可以参考<a href="#m32">语言配置</a></td>
  125. </tr>
  126. <tr>
  127. <td align="center">skin</td>
  128. <td align="center">string</td>
  129. <td align="center">'default'</td>
  130. <td>皮肤名称 默认自带 default和whyGreen两个皮肤<br />
  131. 另外如果你的css够强的话,可以自己做皮肤<br />
  132. 你可以参考<a href="#m33">皮肤配置</a></td>
  133. </tr>
  134. <tr>
  135. <td align="center">dateFmt</td>
  136. <td align="center">string</td>
  137. <td align="center">'yyyy-MM-dd'</td>
  138. <td>日期显示格式<br />
  139. 你可以参考<a href="2.2.asp.htm#m224" tppabs="http://www.my97.net/dp/demo/resource/2.2.asp#m224">自定义格式</a></td>
  140. </tr>
  141. <tr>
  142. <td align="center">realDateFmt</td>
  143. <td align="center">string</td>
  144. <td align="center">'yyyy-MM-dd'</td>
  145. <td rowspan="3">计算机可识别的,真正的日期格式<br />
  146. <span class="STYLE2">无效日期设置(disabledDates),最大日期(maxDate),最小日期(minDate)以及快速日期都必须与它们相匹配<br />
  147. 建议使用默认值</span></td>
  148. </tr>
  149. <tr>
  150. <td align="center">realTimeFmt</td>
  151. <td align="center">string</td>
  152. <td align="center">'HH:mm:ss'</td>
  153. </tr>
  154. <tr>
  155. <td align="center">realFullFmt</td>
  156. <td align="center">string</td>
  157. <td align="center">'%Date %Time'</td>
  158. </tr>
  159. <tr>
  160. <td align="center">minDate</td>
  161. <td align="center">string</td>
  162. <td align="center">'1900-01-01 00:00:00'</td>
  163. <td>最小日期(注意要与上面的real日期相匹配)</td>
  164. </tr>
  165. <tr>
  166. <td align="center">maxDate</td>
  167. <td align="center">string</td>
  168. <td align="center">'2099-12-31 23:59:59'</td>
  169. <td>最大日期(注意要与上面的real日期相匹配)</td>
  170. </tr>
  171. <tr>
  172. <td align="center">startDate</td>
  173. <td align="center">string</td>
  174. <td align="center">''</td>
  175. <td> 起始日期,既点击日期框时显示的起始日期<br />
  176. 为空时,使用今天作为起始日期(默认值)<br />
  177. 否则使用传入的日期作为起始日期(注意要与上面的real日期相匹配)<br />
  178. 你可以参考<a href="2.2.asp.htm#m223" tppabs="http://www.my97.net/dp/demo/resource/2.2.asp#m223">起始日期示例</a></td>
  179. </tr>
  180. <tr>
  181. <td align="center">firstDayOfWeek</td>
  182. <td align="center">int</td>
  183. <td align="center">0</td>
  184. <td>周的第一天 0表示星期日 1表示星期一</td>
  185. </tr>
  186. <tr>
  187. <td align="center">isShowWeek</td>
  188. <td align="center">bool</td>
  189. <td align="center">false</td>
  190. <td>是否显示周<br />
  191. 你可以参考<a href="2.1.asp.htm#m213" tppabs="http://www.my97.net/dp/demo/resource/2.1.asp#m213">周显示示例</a></td>
  192. </tr>
  193. <tr>
  194. <td align="center">highLineWeekDay</td>
  195. <td align="center">bool</td>
  196. <td align="center">true</td>
  197. <td>是否高亮显示 周六 周日</td>
  198. </tr>
  199. <tr>
  200. <td align="center">isShowClear</td>
  201. <td align="center">bool</td>
  202. <td align="center">true</td>
  203. <td>是否显示清空按钮</td>
  204. </tr>
  205. <tr>
  206. <td align="center">isShowToday</td>
  207. <td align="center">bool</td>
  208. <td align="center">true</td>
  209. <td>是否显示今天按钮</td>
  210. </tr>
  211. <tr>
  212. <td align="center">isShowOthers</td>
  213. <td align="center">bool</td>
  214. <td align="center">true</td>
  215. <td>为true时,第一行空白处显示上月的日期,末行空白处显示下月的日期,否则不显示</td>
  216. </tr>
  217. <tr>
  218. <td align="center">readOnly</td>
  219. <td align="center">bool</td>
  220. <td align="center">false</td>
  221. <td>是否只读</td>
  222. </tr>
  223. <tr>
  224. <td align="center">errDealMode</td>
  225. <td align="center">int</td>
  226. <td align="center">0</td>
  227. <td>纠错模式设置 可设置3中模式 0 - 提示 1 - 自动纠错 2 - 标记</td>
  228. </tr>
  229. <tr>
  230. <td align="center">autoPickDate</td>
  231. <td align="center">bool</td>
  232. <td align="center">null</td>
  233. <td><a name="autopickdate" id="autopickdate"></a>为false时 点日期的时候不自动输入,而是要通过确定才能输入<br />
  234. 为true时 即点击日期即可返回日期值<br />
  235. 为null时(推荐使用) 如果有时间置为false 否则置为true</td>
  236. </tr>
  237. <tr>
  238. <td align="center">qsEnabled</td>
  239. <td align="center">bool</td>
  240. <td align="center">true</td>
  241. <td>是否启用快速选择功能</td>
  242. </tr>
  243. <tr>
  244. <td align="center">autoShowQS</td>
  245. <td align="center">bool</td>
  246. <td align="center">false</td>
  247. <td>是否默认显示快速选择</td>
  248. </tr>
  249. <tr>
  250. <td align="center">quickSel</td>
  251. <td align="center">Array</td>
  252. <td align="center">null</td>
  253. <td>快速选择数据,可以传入5个快速选择日期<br />
  254. 注意:日期格式必须与 realDateFmt realTimeFmt realFullFmt 相匹配<br />
  255. 你可以参考<a href="2.6.asp.htm#m26" tppabs="http://www.my97.net/dp/demo/resource/2.6.asp#m26">快速选择示例</a></td>
  256. </tr>
  257. <tr>
  258. <td align="center">disabledDays</td>
  259. <td align="center">Array</td>
  260. <td align="center">null</td>
  261. <td>可以使用此功能禁用周日至周六所对应的日期<br />
  262. 0至6 分别代表 周日至周六<br />
  263. 你可以参考<a href="2.4.asp.htm#m244" tppabs="http://www.my97.net/dp/demo/resource/2.4.asp#m244">无效天示例</a></td>
  264. </tr>
  265. <tr>
  266. <td align="center">disabledDates</td>
  267. <td align="center">Array</td>
  268. <td align="center">null</td>
  269. <td>可以使用此功能禁用所指定的一个或多个日期<br />
  270. 你可以参考<a href="2.4.asp.htm#m245" tppabs="http://www.my97.net/dp/demo/resource/2.4.asp#m245">无效日期示例</a></td>
  271. </tr>
  272. <tr>
  273. <td align="center">opposite</td>
  274. <td align="center">bool</td>
  275. <td align="center">false</td>
  276. <td>默认为false, 为true时,无效日期变成有效日期 <br />
  277. <span class="STYLE1">注意:该属性对无效天特殊天不起作用</span><br />
  278. 你可以参考<a href="2.4.asp.htm#m246" tppabs="http://www.my97.net/dp/demo/resource/2.4.asp#m246">有效日期示例</a></td>
  279. </tr>
  280. <tr>
  281. <td align="center">specialDates</td>
  282. <td align="center">Array</td>
  283. <td align="center">null</td>
  284. <td>特殊日期,对指定的日期进行高亮显示<br />
  285. 你可以参考<a href="2.4.asp.htm#m247" tppabs="http://www.my97.net/dp/demo/resource/2.4.asp#m247">特殊天与特殊日期示例</a></td>
  286. </tr>
  287. <tr>
  288. <td align="center">specialDays</td>
  289. <td align="center">Array</td>
  290. <td align="center">null</td>
  291. <td>特殊天,使用此功能禁用周日至周六所对应的日期进行高亮显示<br />
  292. 0至6 分别代表 周日至周六<br />
  293. 你可以参考<a href="2.4.asp.htm#m247" tppabs="http://www.my97.net/dp/demo/resource/2.4.asp#m247">特殊天与特殊日期示例</a></td>
  294. </tr>
  295. <tr>
  296. <td align="center">onpicking</td>
  297. <td align="center">function</td>
  298. <td align="center">null</td>
  299. <td rowspan="4">此四个参数为事件参数<br />
  300. 你可以参考<a href="2.5.asp.htm#m25" tppabs="http://www.my97.net/dp/demo/resource/2.5.asp#m25">自定义事件示例</a></td>
  301. </tr>
  302. <tr>
  303. <td align="center">onpicked</td>
  304. <td align="center">function</td>
  305. <td align="center">null</td>
  306. </tr>
  307. <tr>
  308. <td align="center">onclearing</td>
  309. <td align="center">function</td>
  310. <td align="center">null</td>
  311. </tr>
  312. <tr>
  313. <td align="center">oncleared</td>
  314. <td align="center">function</td>
  315. <td align="center">null</td>
  316. </tr>
  317. <tr>
  318. <td align="center">ychanging ychanged <br />
  319. Mchanging Mchanged<br />
  320. dchanging dchanged<br />
  321. Hchanging Hchanged<br />
  322. mchanging mchanged<br />
  323. schanging schanged </td>
  324. <td align="center">function</td>
  325. <td align="center">null</td>
  326. <td><span class="STYLE1">(4.6Beta3新增)</span><br />
  327. <br />
  328. y M d H m s 分别表示年月日时分秒<br />
  329. changing 事件发生在属性改变之前<br />
  330. changed 事件发生在属性改变之后<br />
  331. <br />
  332. 你可以参考<a href="2.5.asp-.htm#m254" tppabs="http://www.my97.net/dp/demo/resource/2.5.asp?#m254">示例5-4-1</a></td>
  333. </tr>
  334. </table>
  335. </li>
  336. <li>配置全局默认值<a name="m312" id="m312"></a>
  337. <p>通过配置WdatePicker.js的属性可以避免每次调用都传入配置值,为变成带来很多方便.<br />
  338. 在默认情况下My97为每个属性都配置了默认值,这些默认值都可以在WdatePicker.js中修改的<br />
  339. 你可以根据你个人的喜好更改这些值<br />
  340. <br />
  341. 比如你比较不喜欢默认的皮肤default 而更喜欢 whyGreen 这个皮肤,<br />
  342. 你可以直接在WdatePicker.js把skin值改为 whyGreen<br />
  343. 这样,你就<span class="STYLE2">不必每次调用控件的时候都传入</span> skin:'whyGreen' 了<br />
  344. 你学会了吗?</p>
  345. </li>
  346. <li>配置单个控件<a name="m313" id="m313"></a>
  347. <p>在控件里面你可以使用 onfocus 或 onclick 事件来调用WdatePicker函数来触发日期控件<br />
  348. WdatePicker({})其中{}中的内容都是只对当前实例有效,你可以任意配置属性表里有的所有属性<br />
  349. 你可以随意的组合这些属性,达到你的需求<br />
  350. My97日期控件在这方面是做得非常灵活的.</p>
  351. </li>
  352. <li>多套配置快速切换<a name="m314" id="m314"></a>
  353. <p>您可以设置多个WdatePicker.js文件,如
  354. cn_WdatePicker.js,en_WdatePicker.js,simple_WdatePicker.js等<br />
  355. 在不同的页面引入不同的 WdatePicker.js 达到配置快速切换的目的.<br />
  356. <span class="STYLE1">注意:文件必须以 _WdatePicker.js(大小写不限制) 为后缀,形如 &lt;yourname&gt;_WdatePicker.js</span></p>
  357. </li>
  358. </ol>
  359. <h3>2. 语言配置<a name="m32" id="m32"></a> </h3>
  360. <ol>
  361. <li>语言列表<a name="m321" id="m321"></a><p>My97DatePicker目录下有个config.js(4.8以后在WdatePicker.js中),里面有段代码: <br />
  362. var <span class="STYLE1">langList</span> = <br />
  363. [<br />
  364. {<span class="STYLE2">name:</span><span class="STYLE1">'en'</span>, <span class="STYLE2">charset:</span><span class="STYLE1">'UTF-8'</span>},<br />
  365. {name:'zh-cn', charset:'gb2312'},<br />
  366. {name:'zh-tw', charset:'GBK'}<br />
  367. ];<br />
  368. <br />
  369. 这就是语言列表,每个项有name和charset两个属性.<br />
  370. name 表示语言的名称(必须与浏览器的语言字符串命名相同),在配置的时候,<span class="STYLE2">lang属性只能是配置列表里面已有的项,否则将自动返回第一项</span><br />
  371. charset 表示对应语言目录下的js文件所对应的编码格式</p>
  372. </li>
  373. <li>语言安装说明<a name="m322" id="m322"></a>
  374. <p>分两步轻松实现:<br />
  375. 1 将语言文件拷贝到 lang 目录<br />
  376. 2 打开 config.js 配置语言列表</p>
  377. </li>
  378. </ol>
  379. <h3>3. 皮肤配置<a name="m33" id="m33"></a></h3>
  380. <ol>
  381. <li>皮肤列表<a name="m331" id="m331"></a>
  382. <p>My97DatePicker目录下有个config.js(4.8以后在WdatePicker.js中),里面有段代码:
  383. <br />
  384. var <span class="STYLE1">skinList</span> = <br />
  385. [<br />
  386. {<span class="STYLE2">name:</span><span class="STYLE1">'default'</span>, <span class="STYLE2">charset:</span><span class="STYLE1">'gb2312'</span>},<br />
  387. {name:'whyGreen', charset:'gb2312'},<br />
  388. {name:'blue', charset:'gb2312'},<br />
  389. {name:'simple', charset:'gb2312'} <br />
  390. ];<br />
  391. <br />
  392. 这就是皮肤列表,每个项有name和charset两个属性.<br />
  393. name 表示皮肤的名称,在配置的时候,<span class="STYLE2">skin属性只能是配置列表里面已有的项,否则将自动返回第一项</span><br />
  394. charset 表示对应皮肤目录下的css文件:datepicker.css所对应的编码格式</p>
  395. </li>
  396. <li>皮肤安装说明<a name="m332" id="m332"></a><p>分两步轻松实现:<br />
  397. 1 将皮肤文件包拷贝到 skin 目录<br />
  398. 2 打开 config.js 配置皮肤列表
  399. <br />
  400. <br />
  401. <span class="STYLE1">注意:安装过多的皮肤会影响性能,一般只安装自己使用的皮肤,3个以下比较适宜</span></p>
  402. </li>
  403. </ol>
  404. <h2><a href="999.asp.htm" tppabs="http://www.my97.net/dp/demo/resource/999.asp">四. 如何使用</a><a name="m4" id="m4"></a></h2>
  405. <br />
  406. <br />
  407. </div>
  408. <div style="clear:both"></div>
  409. </div>
  410. <div class="dCenter dBody" style="padding-left:72px">
  411. <script type="text/javascript"><!--
  412. google_ad_client = "ca-pub-6343250634002651";
  413. /* 底部 */
  414. google_ad_slot = "0599809152";
  415. google_ad_width = 728;
  416. google_ad_height = 90;
  417. //-->
  418. </script>
  419. <script type="text/javascript">
  420. </script>
  421. </div>
  422. <div id="footer" class="dCenter">&copy; 2010 <a href="mailto:smallcarrot@163.com">My97</a> All Rights Reserved.&nbsp;&nbsp;&nbsp;&nbsp;<script type="text/javascript">
  423. var _bdhmProtocol = (("https:" == document.location.protocol) ? " https://" : " http://");
  424. document.write(unescape("%3Cscript src='" + _bdhmProtocol + "hm.baidu.com/h.js%3F489957c212e14340592fb2e4921b2f1d' type='text/javascript'%3E%3C/script%3E"));
  425. </script>&nbsp;&nbsp;&nbsp;&nbsp;浙ICP备11060275号
  426. </div>
  427. </body>
  428. </html>