<剑道:组合框>
Kendo UI的JSP包装器组合框.
配置属性
autoBind布尔
控制在初始化时是否将小部件绑定到数据源。
例子
autoWidth布尔
如果设置为true,小部件将自动调整弹出元素的宽度,并且不包装项目标签。
例子
cascadeFrom以
使用它来设置父组合框小部件的Id。说明级联功能如何工作的帮助主题
例子
.
cascadeFromField以
定义用于筛选数据源的字段。如果没有定义,则将其设置为与父选项dataValueField名称相同的字段。说明级联功能如何工作的帮助主题
例子
cascadeFromParentField以
定义用于从中保留值的父字段。这个值将用于进一步筛选数据源。如果没有定义,则使用父类的dataValueField的值。
例子
.
clearButton布尔
除非此选项设置为false,否则在悬停小部件时将出现一个按钮。单击该按钮将重置小部件的值并触发更改事件。
例子
dataTextField以
数据项的字段,提供列表项的文本内容。小部件将根据该字段筛选数据源。
例子
.
dataValueField以
提供小部件值的数据项的字段。
例子
.
延迟浮动
按键和小部件显示弹出窗口之间的毫秒延迟。
例子
启用布尔
如果设置为false,小部件将被禁用,不允许用户输入。该小部件在默认情况下是启用的,并允许用户输入。
例子
.
enforceMinLength布尔
如果设置为true,当搜索输入的文本被清除时,小部件将不会显示所有项目。默认情况下,当清除搜索输入的文本时,小部件将显示所有项。与minLength一起工作。
例子
fillMode以
设置控制颜色应用方式的值。也可以设置为以下字符串值:"none";“固体”;"flat"或"outline"。
例子
.
过滤器以
用于确定当前值建议的过滤方法。默认情况下,过滤是关闭的,并且只能对字符串值执行过滤(小部件的数据必须是字符串数组,或者在dataTextField选项中配置的字段)。支持的过滤器值为“以”开头、“以”结尾和“包含”。
例子
.
fixedGroupTemplate以
用于呈现固定标头组的模板。默认情况下,小部件只显示当前组的值。
例子
footerTemplate以
用于渲染页脚模板的模板。页脚模板接收小部件本身作为数据参数的一部分。直接在模板中使用小部件字段。
例子
.
groupTemplate以
用于呈现组的模板。默认情况下,小部件只显示组的值。
例子
.
headerTemplate以
指定一个静态HTML内容,它将被呈现为弹出元素的标题。
例子
.
高度浮动
建议的高度以像素为单位。默认值为200像素。
例子
.
highlightFirst布尔
如果设置为true,第一个建议将自动高亮显示。
例子
ignoreCase布尔
如果设置为false,将执行区分大小写的搜索以查找建议。默认情况下,小部件执行不区分大小写的搜索。
例子
指数浮动
初始选择项的索引。索引以0为基础。
例子
. .
标签以
在输入前添加一个标签。如果输入没有id属性,则会分配一个生成的id。字符串和函数参数设置标签的内部HTML。进一步的配置可通过剑道:comboBox-label.
例子
最小长度浮动
执行搜索前用户必须输入的最小字符数。如果搜索可以匹配很多项,则设置为高于1的值。
例子
.
noDataTemplate以
用于呈现“无数据”模板的模板,如果没有找到结果或底层数据源为空,将显示该模板。noData模板将小部件本身作为数据参数的一部分接收。模板将在每个小部件数据绑定上进行计算。
例子
占位符以
小部件为空时显示的提示。默认不设置。
例子
.
圆形的以
设置控制边界半径的值。也可以设置为以下字符串值:"none";“小”;“媒介”;“大的”或“满的”。
例子
大小以
设置控制组件大小的值。也可以设置为以下字符串值:"small";“媒介”;"large"或"none"。
例子
.
建议布尔
如果设置为true,小部件将自动使用第一个建议作为它的值。
例子
syncValueAndText布尔
当设置为true时,小部件将自动将所选值设置为键入的自定义文本。将该选项设置为false以清除所选值,但保留自定义文本。
例子
模板以
用于渲染项目的模板。默认情况下,小部件只显示数据项的文本(通过dataTextField配置)。
例子
.
文本以
当autoBind设置为false时使用的小部件的文本。
例子
.
价值以
小部件的值。
例子
. /kendo:comboBox
valuePrimitive布尔
指定当初始模型值为空时小部件的值绑定行为。如果设置为true, View-Model字段将被更新为所选项目值字段。如果设置为false, View-Model字段将随所选项一起更新。
例子
虚拟布尔
启用小部件的虚拟化特性。可以在对象上设置配置,对象包含两个属性——itemHeight和valueMapper。有关详细信息,请参阅关于虚拟化的文章。进一步的配置可通过剑道:comboBox-virtual.
例子
配置JSP标签
剑道:comboBox-animation
配置建议弹出窗口的打开和关闭动画。将动画选项设置为false将禁用开始和结束动画。因此,建议弹出窗口将立即打开和关闭。
更多文档可在剑道:comboBox-animation.
例子
剑道:comboBox-label
在输入前添加一个标签。如果输入没有id属性,则会分配一个生成的id。字符串和函数参数设置标签的内部HTML。
更多文档可在剑道:comboBox-label.
例子
剑道:comboBox-messages
在小部件中显示的文本消息。使用此选项可自定义或本地化消息。
更多文档可在剑道:comboBox-messages.
例子
剑道:comboBox-popup
将用于弹出式初始化的选项。有关可用选项的更多详细信息,请参阅Popup文档。
更多文档可在剑道:comboBox-popup.
例子
剑道:comboBox-virtual
启用小部件的虚拟化特性。可以在对象上设置配置,对象包含两个属性——itemHeight和valueMapper。有关详细信息,请参阅关于虚拟化的文章。
更多文档可在剑道:comboBox-virtual.
例子
事件属性
改变字符串
当用户更改小部件的值时触发。从2015年Q3 SP1开始,级联小部件将在其父更新导致其值更改时触发更改事件。事件处理程序函数上下文(可通过this关键字获得)将被设置为小部件实例。
有关更多信息,请查看改变活动文档。
例子
剑道:comboBox-close
当窗口小部件的弹出窗口关闭时触发。事件处理程序函数上下文(可通过this关键字获得)将被设置为小部件实例。
有关更多信息,请查看关闭活动文档。
例子
.
剑道:comboBox-dataBound
当小部件绑定到来自其数据源的数据时触发。事件处理程序函数上下文(可通过this关键字获得)将被设置为小部件实例。
有关更多信息,请查看数据绑定活动文档。
例子
.
剑道:comboBox-filtering
在小部件准备筛选数据源时触发。事件处理程序函数上下文(可通过this关键字获得)将被设置为小部件实例。
有关更多信息,请查看过滤活动文档。
例子
.
剑道:comboBox-open
当用户打开小部件的弹出窗口时触发。事件处理程序函数上下文(可通过this关键字获得)将被设置为小部件实例。
有关更多信息,请查看开放活动文档。
例子
剑道:comboBox-select
当用户通过鼠标/点击或键盘导航选择弹出窗口中的项目时触发。
有关更多信息,请查看选择活动文档。
例子
.
剑道:comboBox-cascade
当通过API或用户交互更改小部件的值时触发。
有关更多信息,请查看级联活动文档。
例子
.