設計表單時常需要「點一下加一點」的數字控制項,例如數量、份數。与其自己刻上下箭頭與點擊邏輯,用 jQuery Spin Button 插件只要幾行就能搞定。
需要引入 jQuery 主程式與 jQuery Spin Button 插件(目前版本 1.1.1)。
插件需要一組上下箭頭圖片,預設放在 /img/spin/,檔名為 spin-button.png。這個路徑與檔名都可以自訂。
第一步,引入檔案:
<script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="jquery.spin.js"></script>
第二步,寫上 HTML 控制項:
<input type="text" id="number" value="0" />
第三步,啟用插件:
<script type="text/javascript">
$(document).ready(function(){
$('#number').spin();
});
</script>
就這樣。只要準備好按鈕圖片與初始值,數字增減功能立刻可用。
'/img/spin/',按鈕圖片資料夾路徑。'spin-button.png',按鈕圖片檔名。'spin-up.png',向上遞增按鈕圖片。'spin-down.png',向下遞減按鈕圖片。把步長改為 10:
$('#number').spin({interval: 10});
限制在 -100 到 100 之間:
$('#number').spin({max: 100, min: -100});
換一組按鈕圖片:
$('#number').spin({imageBasePath: '/images/'});
整體來說,這個插件的價值在於把「圖片按鈕 + 邊界檢查 + 長按連續遞增」這些瑣碎細節都封好了,一行呼叫就能取得接近原生 number input 的體驗——在還需要支援舊版瀏覽器的年代,這是很划算的選擇。
線上示範:https://demo.jb51.net/js/jquery-spin/index.html