Pivot 控制

用來提供瀏覽的控制項。

Note

完整文件和原始程式碼可在 GitHub 程式碼元件存放庫中找到。

描述

Pivot控制項及相關索引標籤模式可用來瀏覽經常存取的不同內容類別。 Pivot 允許在兩個或多個內容檢視表之間瀏覽，並依靠文字標題來清楚地表述不同的內容區段。

此程式碼元件為 Fluent UI Pivot 控制項提供了一個包裝函式，以便在畫布應用程式和自訂頁面中使用。

內容

索引鍵屬性

屬性	描述
RenderType	要呈現的控制項類型。
SelectedKey	要選取的索引鍵。 當使用者與控制項互動時，會透過 OnChange 事件來更新此項。
Items	要呈現的動作項目

Items 性能

每個項目都使用下列結構描述來視覺化元件中的資料。

姓名	描述
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 Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。 有關如何設定的指南，請參閱佈景主題。
RenderSize	Pivot 控制項可以呈現為兩種大小 (大/一般)
AccessibilityLabel	螢幕助讀程式 aria-label

事件屬性

屬性	描述
InputEvent	要傳送到控制項的事件。 例如 SetFocus。 請參閱下文。

行為

支援將 SetFocus 視為 InputEvent。

設定索引標籤行為

在應用程式中，依相依元件的 Visible 屬性 (例如代表頁面的容器) 與 Pivot1.Selected.ItemKey 的值相關聯，協調索引標籤頁面。

Visible 屬性，該屬性在選擇 tabFile itemKey 時顯示 ：

Pivot1.Selected.ItemKey = "tabFile"

限制

此程式碼元件只能在畫布應用程式和自訂頁面中使用。

在 GitHub 文件的設計挑戰區段中查看更多限制說明。