共用方式為

SubwayNav 控制 (預覽版)

  • 發行項

[本文章是發行前版本文件，且隨時可能變更。]

用於引導使用者完成程序的控制項。

注意

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

SubwayNav 控制項。

重要

  • 這是預覽功能。
  • 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。

描述

SubwayNav 控制項可讓您視覺化精靈所需的步驟。 此精靈是一個引導使用者完成預先定義的步驟以完成安裝或建立工作的元件。

此程式碼元件提供 Office 365 管理員控制項 SubwayNav 分叉版本的包裝函式。

重要

不要向 Admin Controls 團隊 提交 bug - 始終將問題提交到 Creator Kit Github 儲存庫 at aka.ms/creatorkit/bug。

索引鍵屬性

姓名 Description
Items 要呈現的設定 (步驟) 資料表 (請參閱下方的 Items 資料表結構描述)。
WizardCompleteorError 顯示為「SubwayNav 狀態」

Items 表屬性

Items 輸入資料表中的每個物件都必須使用下列屬性才能正確呈現：

姓名 描述
ItemLabel 步驟的標籤
ItemKey 要用於指示選取哪個項目/步驟的索引鍵。 索引鍵必須是唯一的。
ParentItemKey 選用。 上層的 ItemKey，用於呈現子步驟。
ItemState 指定步驟的狀態。 提供下列支援的狀態：
Current， NotStarted， Completed，， Unsaved， ViewedNotCompleted Error， CurrentWithSubSteps，， Skipped WizardComplete
ItemDisabled 選用。 步驟是否已停用。
ItemVisuallyDisabled 選用。 步驟是否已在視覺效果上停用。

其他屬性

姓名 描述
AccessibilityLabel 螢幕報讀軟體 aria-label。
InputEvent 要傳送到控制項的事件。 例如 SetFocus。 請參閱下文。
Theme 接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。

範例

  • 支援將 SetFocus 視為 InputEvent。

Items 屬性的輸入集合值範例：

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2", ItemState:"Completed" },
    { ItemKey:"3", ItemLabel:"Step 3", ItemState:"Unsaved" },
    { ItemKey:"4", ItemLabel:"Step 4", ItemState:"ViewedNotCompleted" },
    { ItemKey:"5", ItemLabel:"Step 5", ItemState:"Error" },
    { ItemKey:"6", ItemLabel:"Step 6", ItemState:"WizardComplete" }
)

若要取得使用者選取的步驟，請使用 SubwayNav 控制項的 OnSelect 或 OnChange 屬性。

範例程式碼：

Notify( Concatenate(Self.Selected.ItemLabel, " selected and its status is ", Self.Selected.ItemState ));

子步驟案例的範例

以下是範例項目集合範例，定義如何使用 ParentItemKey 將子步驟需求與主要/上層步驟連結。

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2 have sub-steps", ItemState:"WizardComplete" },
    { ItemKey:"3", ItemLabel:"Sub Step 2.1", ParentItemKey:"2", ItemState:"Error" },
    { ItemKey:"4", ItemLabel:"Sub Step 2.2", ParentItemKey:"2", ItemState:"WizardComplete" }, 
    { ItemKey:"5", ItemLabel:"Sub Step 3.1", ParentItemKey:"8", ItemState:"ViewedNotCompleted" }, 
    { ItemKey:"6", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"7", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"8", ItemLabel:"Step 3 too have sub-steps", ItemState:"Unsaved" }, 
    { ItemKey:"9", ItemLabel:"Step 4", ItemState:"Error" }, 
    { ItemKey:"10", ItemLabel:"Step 5", ItemState:"WizardComplete" }
)

輸出結構描述

當我們選取或移至不同的步驟時，每個項目 (步驟) 的狀態都會在內部發生變更，尤其是 Current&CurrentWithSubStep。 您可以使用名為 Steps 的輸出屬性來判斷目前狀態。

範例程式碼 (從 SubwayNav 控制項中參考)：

Self.Steps

範例程式碼 (參考另一個控制項中的步驟)：

SubwayNav1.Steps

限制

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