multiselect 属性说明

属性

通过设置参数来制定自己的多选下拉。

属性	说明	默认值
header	可以是一个布尔值，或一个字符串值。如果是布尔值，则控制是否显示标题；如果是字符串，默认的“check all”，“uncheck all”和“close”的链接，将指定的文本替换。	true
height	复选框的容器的高度。如果设置为“auto”，高度将基于菜单的复选框的数值计算。	175
minWidth	在像素的整个部件的最小宽度。设置为“auto”将禁用。	225
checkAllText	"check all"的连接文本。	Check all
uncheckAllText	"uncheck all"的连接文本。	Uncheck All
noneSelectedText	选择框中未选择时的默认文本。	Select options
selectedText	选择框中选择时的默认文本，#代表选择的件数，例如"#selected",如果有5条数据被选中时，则显示"5 selected"。	# selected
selectedList	一个数字（或布尔禁用）表示在一个列表中显示行数。0或false则不控制。	false
show	控制菜单展开的速度，数组传递： ['slide', 500]。	empty string
hide	控制菜单关闭的速度，数组传递： ['explode', 500]。	empty string
autoOpen	一个布尔值，控件初始化时，指示是否自动打开菜单。	false
multiple	如果设置为fasle，该控件将使用单选按钮代替复选框，用户只能选择一个选项。	true
classes	1.5以上版本，样式设置，可以控制按钮和菜单的样式，多个样式用空格分隔，按钮和菜单设置时需要区分：css /* button */ .ui-multiselect.myClass {} /* menu */ .ui-multiselect-menu.myClass {}。	empty string
position	1.5以上版本，用于设置菜单相对于按钮的位置：中心，上面，下面（默认）。	empty object

事件

事件	说明
create	需要 jQuery UI Widget Factory 1.8.6+ ，当插件创建时触发。
beforeopen	在菜单打开之前触发，通过返回false防止打开菜单。
open	在菜单打开时触发。
beforeclose	在菜单关闭之前触发，通过返回false防止关闭菜单。
close	在菜单关闭时触发。
checkall	全选按钮点击的触发事件。
uncheckall	全选取消按钮点击的触发事件。
optgrouptoggle	当optgroup 标签被选中时触发，这一事件接收原始事件对象作为第一个参数，和一个哈希值作为第二个参数：  js $("#multiselect").bind("multiselectoptgrouptoggle", function(event, ui){  /* event: 原始事件对象     ui.inputs: optgroup 标签集合     ui.label: optgroup 标签的文本     ui.checked: 是否进行切换复选框或不 (boolean) */  });
click	在菜单中的复选框被选中或取消时触发： js $("#multiselect").on("multiselectclick", function(event, ui) { /* event：原始事件对象     ui.value：复选框的值     ui.text：复选框的文本     ui.checked：是否被选中或取消选中（布尔）*/  });

方法

方法	说明
open	打开菜单。
close	关闭菜单。
refresh	重新加载该复选框菜单。如果你是动态添加/删除选项标签在原来的选择通过AJAX或DOM操作方法，调用Refresh反映在控件中的变化。
disable	禁用整个部件。
enable	使用整个部件。
checkAll	全选择。
uncheckAll	全不选。
isOpen	返回一个布尔值判断部件是否打开。
getChecked	返回数组的所有选中的复选框。
getButton	新版本1.13！返回按钮元素。
widget	返回菜单容器（所有内部复选框）。
option	设置或获取一个选项后的部件已经初始化。如果更改选项，该选项设置将立即生效。
destroy	破坏的部件，并回复到原来的选择框。