3.5.2.1.29. 选项列表

在线示例

API 文档

OptionsList 是 OptionsGroup 组件的变体，它将选项列表展示为可垂直滚动的列表。如果启用了多选，则可以通过单击时按住 Ctrl 键来选择多个选项，或按住 Shift 键来选择一个范围内的选项。

gui optionsList

该组件对应的 XML 名称： optionsList

默认情况下，OptionsList 组件在建议弹窗中显示第一个空元素，可以通过将 nullOptionVisible 属性设置为 false 来禁止此行为。

使用 addDoubleClickListener() 可以监听 DoubleClickEvent，用来拦截组件选项上的双击事件。

  1. optionsList.addDoubleClickListener(doubleClickEvent ->
  2.         notifications.create()
  3.         .withCaption("Double clicked")
  4.         .show());

同样，也可以在界面控制器中订阅组件的双击事件，示例：

  1. @Subscribe("optionsList")
  2. private void onOptionsListDoubleClick(OptionsList.DoubleClickEvent event) {
  3.     notifications.create()
  4.             .withCaption("Double clicked")
  5.             .show();
  6. }

OptionsList 和 OptionsGroup API 之间的唯一区别是 OptionsList 没有 orientation 属性。

optionsList 的属性

align - caption - captionAsHtml - captionProperty - contextHelpText - contextHelpTextHtmlEnabled - css - datasource - description - descriptionAsHtml - editable - enable - box.expandRatio - height - icon - id - multiselect - nullOptionVisible - optionsDatasource - optionsEnum - property - required - requiredMessage - stylename - tabIndex - visible - width

optionsList 的元素

validator

API

addDoubleClickListener - addValueChangeListener - setContextHelpIconClickHandler - setOptionCaptionProvider