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


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

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

依赖

  • menubutton

用法

创建搜索框(Searchbox)

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

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

2、编程创建。

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

$('#ss').searchbox({
    searcher:function(value,name){
    alert(value + "," + name)
    },
    menu:'#mm',
    prompt:'Please Input Value'
});

属性

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

方法

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