menuFilterField 菜单过滤器

menuFilterField 组件支持用户对主菜单项进行过滤。

  • XML 元素：menuFilterField

  • Java 类：MenuFilterField

基本用法

下面是在主视图中使用 menuFilterField 组件的示例：

<menuFilterField placeholder="Search..."
                 classNames="ms-s me-s"
                 menu="menu"/> (1)
<nav id="navigation"
     classNames="jmix-main-view-navigation"
     ariaLabel="msg://navigation.ariaLabel">
    <listMenu id="menu"/>
</nav>
1 menu 属性需设置为一个 listMenu 组件。
menuFilterField
目前暂不支持对 horizontalMenu 进行过滤。

样式版本

使用 themeNames 属性可以自定义组件的样式。

样式 描述 支持的主题

align-left

字段值左对齐。

Aura, Lumo

align-center

字段值居中对齐。

Aura, Lumo

align-right

字段值右对齐。

Aura, Lumo

align-start

根据当前文本方向，将字段值向起始侧对齐。

Aura

align-end

根据当前文本方向，将字段值向末尾侧对齐。

Aura

helper-above-field

帮助文字显示在字段上方，标题下方。

Aura, Lumo

small

组件更小。

Aura, Lumo

XML 属性

id - alignSelf - ariaLabel - ariaLabelledBy - autofocus - autoselect - classNames - clearButtonVisible - colspan - css - enabled - filterMode - focusShortcut - height - helperText - label - maxHeight - maxWidth - menu - minHeight - minWidth - placeholder - readOnly - tabIndex - themeNames - title - value - valueChangeMode - valueChangeTimeout - visible - width

filterMode

filterMode 属性设置 menuFilterField 的过滤模式。用于控制搜索时如何匹配菜单项。下面是对大小写敏感的设置：

  • CASE_SENSITIVE - 大小写严格匹配。

  • CASE_INSENSITIVE - 忽略大小写。

menu 属性需设置为一个 listMenu 组件，对其进行过滤。该属性为必需属性。

事件和处理器

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

AttachEvent - DetachEvent - InputEvent - KeyDownEvent - KeyPressEvent - KeyUpEvent - BlurEvent - FocusEvent