Mashup Builder > 小组件 > 标准小组件 > 菜单栏小组件 (可应用主题)
菜单栏小组件 (可应用主题)
* 
此小组件是可用作预览的 web 组件。它包括当前菜单小组件中的功能的子集。在未来版本中将添加其他功能和迁移支持。
使用菜单栏小组件为包含多个混搭或页面的解决方案创建导航布局。小组件会将导航链接显示为可供用户从中选取的项列表。您可以配置小组件上的每个项,以将用户导航到混搭、网页或子菜单。小组件将永久显示在布局中顶级容器的左侧。您可以使用小组件创建具有单一或多个导航级别的菜单。可通过在 Composer 中创建菜单实体或通过编写用于生成数据驱动菜单的数据服务来定义菜单项。这可让您跨多个页面构建具有不同视图的更复杂混搭。
有关定义菜单项以及使用小组件替换内置混搭的方法,请观看以下视频。要在新选项卡中打开视频,请单击播放器上的标题。
除 Mashup Builder 小组件外,菜单栏还包括以下组件:
MenuEntry 数据形状。用于在数据服务中定义菜单栏配置的信息表。
混搭和主布局模板,其中包括预配置布局容器和菜单栏小组件。使用此模板可快速创建简单布局。
已知问题
菜单实体中配置为“退出登录”的菜单项仅在 ThingWorx 9.4 以上版本中受支持。要在较早版本中使用此功能,请改用菜单小组件。
选取菜单设计:可折叠面板和级联菜单
您可以配置小组件以使用 SubMenuType 属性控制导航的多个级别在菜单栏上的显示方式。子菜单将以下列两种方式之一显示:
级联菜单 (默认) - 在右侧打开,其中每个导航级别显示为一个单独的子菜单。
嵌套可折叠面板部分 - 竖直打开,每个导航级别会向右缩进。
下图左侧显示的是默认级联菜单,右侧显示的是嵌套可折叠菜单。
在这两个菜单栏小组件中,已禁用精简视图且已为主要和次要导航数据属性选择了相同菜单实体。级联菜单分为三个部分。顶部的部分用于显示主要导航项。底部的两个部分将显示次要导航项和页脚。在可折叠面板菜单中,显示在页脚上方的次要导航项与主要项已合并为一部分。
* 
页脚部分不受菜单栏类型的影响。
菜单栏剖析
有多种方法可用于配置菜单栏小组件。下图显示了采用默认配置的级联菜单。
1. 展开和折叠切换按钮 (可选)
2. 主要导航项
3. 用于增大或减小菜单栏宽度的拖动控制滑块 (可选)。
4. 次要导航项 (可选)
5. 页脚部分 (可选)
小组件顶层的项会竖直列出。小组件包含多个显示菜单项的部分,具体取决于当前配置。
键盘导航和焦点
您可以借助常用键盘快捷方式在菜单栏上的各个项之间导航,可使用以下键。
说明
TAB
SHIFT+TAB
将焦点框移至小组件内的下一部分,例如展开/折叠按钮、次要和主导航项以及页脚。要将焦点设置于上一部分,请按 SHIFT+TAB。
ENTER
SPACE
展开或折叠包含子菜单的父项。
打开或关闭某一部分。
上/下箭头
将焦点设置于当前部分中的下一个或上一个菜单项。
右/左箭头
将焦点设置于当前部分中的下一个或上一个子菜单级别。
HOME
将焦点设置于当前部分中的第一项。
END
将焦点设置于当前部分中的最后一项。
小组件属性
下表列出了菜单栏小组件的属性。
属性
说明
基本类型
默认值
绑定
可本地化
AlwaysOpen
隐藏用于在展开和精简视图模式之间切换菜单的展开/折叠按钮。要禁用精简视图模式,请将此属性设置为 True。
BOOLEAN
False
N
DataSource
用于指定:是使用信息表还是菜单实体来定义菜单栏中的项。可选择以下选项之一:
“菜单实体”- 选择要显示的菜单项所在的菜单实体。要选择菜单实体,请使用 PrimaryNavMenuSecondaryNavMenu 属性。
“信息表”- 绑定包含数据服务菜单项定义的信息表。必须使用 MenuEntry 数据形状设置信息表的格式。要绑定菜单数据,请使用 PrimaryNavDataSecondaryNavData 属性。
STRING
信息表
In
N
DisableResizing
移除允许用户在运行时更改菜单栏宽度的拖动控制滑块。
BOOLEAN
False
N
Disabled
禁用混搭上的小组件。已禁用的小组件可见,但不是交互式。
BOOLEAN
False
In
N
FooterIcon
页脚部分中显示的图标。页脚图标对于所有菜单类型均可见,包括级联菜单和可折叠面板。
IMAGE
不适用
N
FooterLinkTargetWindow
用于控制:是在同一窗口还是在新窗口中打开页脚链接。可以将此选项设置为“同一窗口”“新窗口”
STRING
同一窗口
N
FooterText
指定要在页脚部分显示的文本。
STRING
不适用
In
FooterURL
用于设置:单击页脚链接时导航所至的 URL。
STRING
不适用
In
N
FooterLogo
小组件处于展开状态时显示在页脚部分的徽标。
* 
适用于 ThingWorx 9.3 或更高版本。
IMAGE
不适用
N
HideAlteranteIcons
当菜单项的自定义图标缺失时,隐藏原本自动显示的替代图标。
BOOLEAN
False
N
HideFooter
隐藏菜单栏上的页脚部分。
BOOLEAN
False
In
N
MashupControl
用于控制:运行时菜单栏在混搭之间导航的方式。可选择以下选项之一:
“控制当前混搭”- 替换整个混搭。
“绑定到混搭参数”- 仅替换内置混搭。添加必须绑定到内置混搭小组件的名为 Mashup 的小组件属性。
STRING
控制当前混搭
N
Mashup
文本属性,包含菜单栏上当前选定混搭的名称。使用此属性可指定要在内置混搭小组件中显示的混搭。
STRING
不适用
Out
N
MaxWidth
菜单栏的最大宽度。菜单栏已展开时,此属性适用。
NUMBER
不适用
In
N
MinWidth
菜单栏的最小宽度。
NUMBER
不适用
In
N
PrimaryNavData
绑定信息表以定义主导航部分的项。必须使用 MenuEntry 数据形状设置信息表的格式。
INFOTABLE
不适用
In
N
PrimaryNavIcons
在菜单栏上显示主要导航项的图标。这些图标在选定菜单实体或绑定信息表中定义。
IMAGE
False
N
PrimaryNavMaxItems
设置在主导航部分中显示的项数的最大值。菜单实体中的其他项会显示在溢出菜单中。
NUMBER
5
In
N
SecondaryNavIcons
在菜单栏上显示次要导航项的图标。这些图标在选定菜单实体或绑定信息表中定义。
IMAGE
False
N
SecondaryNavData
绑定包含次要导航项的各个项的信息表。必须使用 MenuEntry 数据形状设置信息表的格式。
INFOTABLE
不适用
In
N
ShowDataLoading
绑定信息表以定义次要导航部分的项。必须使用 MenuEntry 数据形状设置信息表的格式。
BOOLEAN
True
N
StayOpenOnSelection
当菜单栏上的某一项被选中时,使折叠面板区域保持打开
* 
适用于 ThingWorx 9.3.3 或更高版本。
BOOLEAN
False
N
SubMenuMaxWidth
级联子菜单的最大宽度。
NUMBER
不适用
N
SubMenuMinWidth
级联子菜单的最小宽度。
NUMBER
不适用
N
SubMenuType
用于控制:当小组件包含多级导航时,如何显示菜单项。
级联菜单
嵌套折叠面板
STRING
级联菜单
In
N
TabSequence
按 TAB 键时显示的小组件序列号。
NUMBER
不适用
N
Visible
用于控制菜单栏小组件的可见性。
BOOLEAN
True
In
N
这对您有帮助吗?