listBox 列表选择器

listBox 支持用户从可滚动的列表选择单一值。

  • XML 元素：listBox

  • Java 类：JmixListBox

基本用法

listbox 支持使用枚举或实体集合作为选项列表。

用 itemsEnum 属性直接指定枚举类的名称：

<listBox itemsEnum="com.company.onboarding.entity.OnboardingStatus"/>

如果是实体集合，则可以先定义一个集合数据容器，然后设置 itemsContainer 属性：

<data>
    <collection class="com.company.onboarding.entity.City" id="citiesDc"> (1)
        <fetchPlan extends="_base"/>
        <loader id="citiesDl">
            <query>
                <![CDATA[select e from City e]]>
            </query>
        </loader>
    </collection>
</data>
<layout>
    <listBox itemsContainer="citiesDc"/> (2)
</layout>
1 City 实体的 CollectionContainer。
2 设置 citiesDc 作为组件的选项容器。
list box basics

XML 属性

id - classNames - colspan - enabled - height - itemsContainer - itemsEnum - maxHeight - maxWidth - minHeight - minWidth - readOnly - visible - width

事件和处理器

AttachEvent - ComponentValueChangeEvent - DetachEvent - itemEnabledProvider - itemLabelGenerator

在 Jmix Studio 生成处理器桩代码时，可以使用 Jmix UI 组件面板的 Handlers 标签页或者视图类顶部面板的 Generate Handler 添加，也可以通过 Code → Generate 菜单（Alt+Insert / Cmd+N）生成。

XML 内部元素

tooltip

参考

Vaadin 文档