jQuery EasyUI 基础教程插件 - Searchbox 搜索框


通过 $.fn.searchbox.defaults 重写默认的 defaults。

搜索框(searchbox)提示用户输入搜索值。它可以结合一个菜单,允许用户选择不同的搜索类别。当用户按下 ENTER 键时或者点击组件右侧的搜索按钮时,搜索动作将被执行。

依赖

  • menubutton

用法

创建搜索框(Searchbox)

1、从标记创建。把 'easyui-searchbox' class 加入到 <input> 标记。

  1. <script type="text/javascript">
  2.     function qq(value,name){
  3.     alert(value+":"+name)
  4.     }
  5. </script>
  6. <input id="ss" class="easyui-searchbox" style="width:300px"
  7.     data-options="searcher:qq,prompt:'Please Input Value',menu:'#mm'"></input>
  8. <div id="mm" style="width:120px">
  9.     <div data-options="name:'all',iconCls:'icon-ok'">All News</div>
  10.     <div data-options="name:'sports'">Sports News</div>
  11. </div>

2、编程创建。

  1. <input id="ss"></input>
  2. <div id="mm" style="width:120px">
  3.     <div data-options="name:'all',iconCls:'icon-ok'">All News</div>
  4.     <div data-options="name:'sports'">Sports News</div>
  5. </div>

  1. $('#ss').searchbox({
  2.     searcher:function(value,name){
  3.     alert(value + "," + name)
  4.     },
  5.     menu:'#mm',
  6.     prompt:'Please Input Value'
  7. });

属性

名称类型描述默认值
widthnumber组件的宽度。auto
heightnumber组件的高度。该属性自版本 1.3.2 起可用。22
promptstring显示在输入框里的提示信息。''
valuestring输入的值。''
menuselector搜索类型的菜单。每个菜单项可以有下列的属性:
name:搜索类型名称。
selected:当前选择的搜索类型名称。
下面的实例演示了如何定义一个选中的搜索类型名称。
  1. <input class="easyui-searchbox" style="width:300px" data-options="menu:'#mm'" />
  2. <div id="mm" style="width:150px">
  3. <div data-options="name:'item1'">Search Item1</div>
  4. <div data-options="name:'item2',selected:true">Search Item2</div>
  5. <div data-options="name:'item3'">Search Item3</div>
  6. </div>
null
searcherfunction(value,name)当用户按下搜索按钮或者按下 ENTER 键时,searcher 函数将被调用。null

方法

名称参数描述
optionsnone返回选项(options)对象。
menunone返回搜索类型的菜单对象。 下面的实例演示如何改变菜单项图标。
  1. var m = $('#ss').searchbox('menu');  // get the menu object
  2. var item = m.menu('findItem', 'Sports News');  // find the menu item
  3. // change the menu item icon
  4. m.menu('setIcon', {
  5. target: item.target,
  6. iconCls: 'icon-save'
  7. });
  8. // select the searching type name
  9. $('#ss').searchbox('selectName', 'sports');
textboxnone返回文本框对象。
getValuenone返回当前的搜索值。
setValuevalue设置新的搜索值。
getNamenone返回当前的搜索类型名称。
selectNamename选择当前的搜索类型名称。 代码实例:
  1. $('#ss').searchbox('selectName', 'sports');
destroynone销毁该组件。
resizewidth重设组件的宽度。