Searchbox 是 EasyUI 中的搜尋輸入元件,底層擴充自 $.fn.searchbox.defaults,並依賴 menubutton——因為它可以在輸入框左側帶一個可切換的搜尋類型下拉選單。

為 <input/> 加上 easyui-searchbox 類別即可,其餘設定透過屬性宣告:
<script type="text/javascript">
function qq(value, name) {
alert(value + ":" + name);
}
</script>
<input id="ss" class="easyui-searchbox"
searcher="qq"
prompt="Please Input Value"
menu="#mm"
style="width:300px"></input>
<div id="mm" style="width:120px">
<div name="all" iconCls="icon-ok">All News</div>
<div name="sports">Sports News</div>
</div>
<input id="ss"></input>
<div id="mm" style="width:120px">
<div name="all" iconCls="icon-ok">All News</div>
<div name="sports">Sports News</div>
</div>
$('#ss').searchbox({
width: 200,
searcher: function (value, name) {
alert(value + "," + name);
},
menu: '#mm',
prompt: 'Please Input Value'
});
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| width | number | 設定元件的寬度。 | auto |
| prompt | string | 顯示在輸入框中的提示訊息。 | '' |
| value | string | 輸入的值。 | '' |
| menu | selector | 搜尋類型的選單。 | null |
| searcher | function(value,name) | 使用者按下搜尋鈕或 ENTER 鍵時被呼叫的函式。 | null |
| 名稱 | 參數 | 說明 |
|---|---|---|
| options | none | 回傳 options 物件。 |
| menu | none | 回傳搜尋類型的選單物件。 |
| textbox | none | 回傳文字框物件。 |
| getValue | none | 回傳目前的搜尋值。 |
| setValue | value | 設定新的搜尋值。 |
| getName | none | 回傳目前搜尋類型的名稱。 |
| destroy | none | 銷毀這個元件。 |
| resize | width | 重設元件寬度。 |
原文表格中的 propmt 是 prompt 的筆誤,實測無效,請以 prompt 為準。另外 searcher 的第二個參數 name 對應選單項的 name 屬性,若要依搜尋類型送出不同查詢條件,就是靠它來分流;用標記建立時 searcher 只能填全域函式名稱,若要寫成閉包或帶上下文,建議改用程式建立的方式。