combox 是一個在原生 <select> 基礎上增強的下拉輸入元件,介面原型參考 Dojo 的 combobox 設計,支援鍵盤操作、自動篩選與高亮比對,且程式碼相當精簡,功能比網路上常見的 jQuery 版本更完整。
可以直接以程式碼初始化:
var c = new combox(document.getElementById('a'));
// 或帶入設定
var c = new combox(document.getElementById('a'), { debug: true });
也可以透過 CSS 類別宣告,只要 class 中包含 combox 即可,同時搭配其他樣式也沒問題:
<select class="abc combox def">
· debug:true/false,是否讓原始 select 元素保持可見。
· searchMode:0 為模糊不分大小寫,1 為前綴搜尋不分大小寫。
· remoteSourceUrl:遠端資料來源網址,支援 JSON 格式。
· remoteFilterUrl:篩選時讀取的遠端網址,以 ~!value!~ 作為巨集,觸發時會被替換成目前輸入框的值。
· allowAnyValue:預設 false,不允許輸入 options 以外的值。
· displayValue:顯示值;若能對應到 options 中的 value 則顯示其 text,否則直接顯示該值。
· pleaseSelect:當輸入框值為此文字時,展開時顯示全部 options。
· mouseDblClick:0 為單擊展開,1 為雙擊展開。
舉例:
var c = new combox(document.getElementById('a'), {
allowAnyValue: true,
pleaseSelect: '請選擇',
debug: true
});
專案已開源於 Google Code,並提供線上展示與下載頁面,方便直接評估是否符合自身專案需求。