3.5.2.1.29. 选项列表
OptionsList
是 OptionsGroup 组件的变体,它将选项列表展示为可垂直滚动的列表。如果启用了多选,则可以通过单击时按住 Ctrl 键来选择多个选项,或按住 Shift 键来选择一个范围内的选项。
该组件对应的 XML 名称: optionsList
默认情况下,OptionsList
组件在建议弹窗中显示第一个空元素,可以通过将 nullOptionVisible
属性设置为 false
来禁止此行为。
使用 addDoubleClickListener()
可以监听 DoubleClickEvent
,用来拦截组件选项上的双击事件。
optionsList.addDoubleClickListener(doubleClickEvent ->
notifications.create()
.withCaption("Double clicked")
.show());
同样,也可以在界面控制器中订阅组件的双击事件,示例:
@Subscribe("optionsList")
private void onOptionsListDoubleClick(OptionsList.DoubleClickEvent event) {
notifications.create()
.withCaption("Double clicked")
.show();
}
OptionsList
和 OptionsGroup API 之间的唯一区别是 OptionsList
没有 orientation
属性。
- optionsList 的属性
-
align - caption - captionAsHtml - captionProperty - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - description - descriptionAsHtml - editable - enable - box.expandRatio - height - htmlSanitizerEnabled - icon - id - multiselect - nullOptionVisible - optionsContainer - optionsEnum - property - required - requiredMessage - stylename - tabIndex - visible - width
- optionsList 的元素
- API
-
addDoubleClickListener - addValueChangeListener - setContextHelpIconClickHandler - setOptionCaptionProvider