jQuery EasyUI 教程

jQuery EasyUI 基础插件 - Searchbox 搜索框


jQuery EasyUI 插件 jQuery EasyUI 插件

通过 $.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'
});

属性

名称 类型 描述 默认值
width number 组件的宽度。 auto
height number 组件的高度。该属性自版本 1.3.2 起可用。 22
prompt string 显示在输入框里的提示信息。 ''
value string 输入的值。 ''
menu selector 搜索类型的菜单。每个菜单项可以有下列的属性:
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
searcher function(value,name) 当用户按下搜索按钮或者按下 ENTER 键时,searcher 函数将被调用。 null

方法

名称 参数 描述
options none 返回选项(options)对象。
menu none 返回搜索类型的菜单对象。
下面的实例演示如何改变菜单项图标。
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');
textbox none 返回文本框对象。
getValue none 返回当前的搜索值。
setValue value 设置新的搜索值。
getName none 返回当前的搜索类型名称。
selectName name 选择当前的搜索类型名称。
代码实例:
$('#ss').searchbox('selectName', 'sports');
destroy none 销毁该组件。
resize width 重设组件的宽度。

jQuery EasyUI 插件 jQuery EasyUI 插件