Breadcrumb 控制

用于提供导航的控件。

备注

GitHub 代码组件存储库中的完整文档和源代码。

说明

Breadcrumb 控件应用作 App 或 Site 中的导航辅助工具。 它们指示当前页面在层次结构中的位置，并帮助用户了解它们相对于该层次结构的其余部分的位置。 Breadcrumb 还提供对该层次结构更高级别的一键式访问。

此代码组件提供了一个围绕 Fluent UI Breadcrumb 控件的包装器，用于画布应用和自定义页面。

属性

键属性

属性	说明
SelectedKey	表示选择的键。 当用户与控件交互时，此值将通过 OnChange 事件更新。
Items	要呈现的操作项

Items 性能

每个项使用以下架构来可视化组件中的数据。

Name	说明
ItemDisplayName	痕迹导航项的显示名称
ItemKey	用于指示选择了哪个项以及何时添加子项的键。 键必须是唯一的。
ItemClickable	设置为 false 以防特定的痕迹导航项不可点击。

Power Fx 公式示例：

Table(
    {
        ItemKey: "1",
        ItemDisplayName: "General",
        ItemClickable: true
    },
    {
        ItemKey: "2",
        ItemDisplayName: "Document",
        ItemClickable: true
    }
)

样式属性

Name	说明
Theme	接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。 有关如何配置的指导，请参阅主题化。
AccessibilityLabel	屏幕阅读器 aria 标签
MaxDisplayedItems	合并前显示的最大痕迹导航数。 如果为零，将呈现所有痕迹导航。
OverflowIndex	溢出项将被折叠的可选索引。 默认设置为零。

事件属性

Name	说明
InputEvent	要发送到控件的事件。 例如，SetFocus。 请参阅以下内容。

行为

支持 SetFocus 作为 InputEvent。

配置“选择时”行为

使用组件的 OnSelect 属性中的 Switch() 公式通过引用控件选择的作为切换值的 ItemKey 来配置每个项目的特定操作。

使用 Power Fx 语言的适当表达式替换 false 值。

由于此控件用于导航，因此逻辑操作是使用导航函数（理想情况下是使用加载了相关数据的相关屏幕）。

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "1", false,
    
    /* Action for ItemKey 2 */
    "2", false,
  
    /* Default action */
        false
  )

将焦点设置在控件上

当显示一个新对话，并且默认焦点应在控件上时，需要显式设置焦点。

要调用输入事件，您可以将绑定到 Input Event 属性的上下文变量设置为以 SetFocus 开头、后跟随机元素的字符串，以确保应用将其检测为更改。

Power Fx 公式示例：

UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) }));

上下文变量 ctxResizableTextareaEvent 然后将被绑定到属性 Input Event。

限制

此代码组件只能在画布应用和自定义页面中使用。