Pivot 控制

用于提供导航的控件。

备注

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

说明

Pivot 控件和相关选项卡模式用于导航经常访问的不同内容类别。 Pivot 允许在两个或多个内容视图之间导航，依赖文本标题来表达内容的不同部分。

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

属性

键属性

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

Items 性能

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

Name	说明
ItemDisplayName	导航项的显示名称
ItemKey	用于指示选择了哪个项以及何时添加子项的键。 键必须是唯一的。
ItemEnabled	如果选项被禁用，设置为 false
ItemVisible	如果选项不可见，设置为 false
ItemChecked	如果选项被选中（例如，命令栏中的拆分按钮），设置为 true
ItemIconName	要使用的 Fluent UI 图标（请参阅 Fluent UI 图标）
ItemCount	在回转项目链接上显示项计数。

示例:

Table(
  {
      ItemKey: "tabFile",
      ItemDisplayName: "File"
  },
  {
      ItemKey: "tabHome",
      ItemDisplayName: "Home"
  },
  {
      ItemKey: "tabView",
      ItemDisplayName: "View"
  },
  {
      ItemKey: "tabAction",
      ItemDisplayName: "Action"
  }
)

样式属性

属性	说明
Theme	接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。 有关如何配置的指导，请参阅主题化。
RenderSize	Pivot 控件可以按两种大小呈现（大/正常）
AccessibilityLabel	屏幕阅读器 aria 标签

事件属性

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

行为

支持 SetFocus 作为 InputEvent。

配置选项卡行为

通过将应用中依赖组件（例如，表示页面的容器）的 Visible 属性与 Pivot1.Selected.ItemKey 的值相关联来协调标签页。

Visible 属性，该属性在选择 tabFile itemKey 时显示 ：

Pivot1.Selected.ItemKey = "tabFile"

限制

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

在 GitHub 文档的设计挑战一节查看更多限制说明。