DIV CSS 佈局教程網

jQuery 自製時間選擇插件 setTime() 的呼叫與參數配置實例
編輯:JQuery特效代碼     

時間選擇器在後台系統裡幾乎是標配。這份範例展示一個自製的 setTime() 插件如何套用到多個輸入框,並透過參數做出不同的行為與限制。

一、頁面結構與引入

<!dooCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
  <meta charset = utf8>
  <title>jQuery 實現的輸入框選擇時間插件</title>
  <script charset="utf-8" src="/js/jquery-1.6.2.min.js"></script>
  <script charset="utf-8" src="/js/jquery.settime.js"></script>
</head>
<body>
  <p id="msg">msg</p>
  <p>time1<input id="time"  value="" /></p>
  <p>time2<input id="time2" value="" /></p>
  <p>time3<input id="time3" value="" /></p>
  <p><input type="button" id="button" value="button"/></p>
  <div></div>

二、三種呼叫方式

// 最簡:全部使用預設值
$('#time').setTime();

// 進階:完整參數配置
$('#time2').setTime({
    drag: true,          // 是否可拖曳時間面板
    h: [5, 20],          // 時的範圍
    i: [5, 50],          // 分
    s: [5, 45],          // 秒
    a: 0.05,             // 動畫/透明度步進
    constraint: '',
    'starteffect': function(d){
        $('#msg').html(d[0]);
    },
    'onmove': function(e){
        $('#msg').html(e[0] + '/' + e[1]);
    },
    zindex: '0',
    'cursor': 'move',
    'area': [[50, 600], [10, 5000]],   // 可移動的範圍限制
    'callback': function(){
        // 選擇完成後的回呼
    }
});

// 折衷:只開拖曳並調整速度
$('#time3').setTime({
    drag: true,
    a: 0.05
});

// 讀取目前選到的值
$('#button').click(function(){
    alert( $('#time').val() );
    alert( $('#time2').val() );
    alert( $('#time3').val() );
});
</script>
</body>
</html>

三、參數怎麼讀

  • drag:面板能不能拖到別的位置,避免遮擋重要欄位。
  • h / i / s:時、分、秒的合法範圍,用二元陣列表示上下限。後台系統若只營業到某個時段,就靠這裡限制。
  • area:拖曳的活動範圍,格式是「可移動距離」的上下限,避免面板被拖出視窗外。
  • starteffect / onmove / callback:分別對應開始拖曳、移動中、完成選擇三個時機的回呼。範例中把互動狀態寫進 #msg,方便除錯時觀察插件行為。
  • zindex / cursor:層級與游標樣式,屬於外觀微調。

四、自製時間插件的三個設計原則

  1. 取值一律走 .val()。插件最後必須把結果寫回 input 的 value,這樣表單才能正常送出,也不會綁死在某一種頁面框架上。
  2. 預設值要能單獨運作。$('#time').setTime() 不帶參數就能用,是所有 jQuery 插件的基本禮貌。
  3. 回呼要分階段。拖曳、移動、確認是三件不同的事,給出對應的 hook,使用者才能做出「拖曳時顯示提示、確認後發請求」這種細節。

本文使用的時間插件 jquery.settime.js 可於本站下載取得。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved