Поділитися через

SubwayNav control (підготовча версія)

  • Стаття

[Ця стаття стосується попередньої версії, і її буде змінено.]

Елемент керування, який використовується для керівництва користувачами процесом.

Нотатка

Повна документація та вихідний код можна знайти в репозиторії компонентів коду GitHub.

Управління SubwayNav.

Важливо

  • Це функція попереднього перегляду.
  • Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Опис

Елемент SubwayNav керування дозволяє візуалізувати кроки, необхідні для даного майстра. Майстер — це компонент, який допомагає користувачам виконувати попередньо визначені кроки для виконання завдання з налаштування або створення.

Цей компонент коду надає обгортку навколо розгалуженої версії Office 365 Admin Control SubwayNav.

Важливо

Не відкривайте помилки за допомогою команди Admin Controls - завжди надсилайте проблеми до репозиторію Creator Kit на Github за адресою aka.ms/creatorkit/bug.

Ключові властивості

Ім'я Опис
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 Приймає рядок JSON, створений за допомогою конструктора тем Fluent UI (windows.net). Якщо залишити це значення пустим, використовуватиметься тема, визначена 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" }
)

Щоб отримати вибраний користувачем крок, використовуйте OnSelect властивість або OnChange елемента SubwayNav керування.

Приклад коду:

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

Приклад для сценаріїв Substep

Нижче наведено приклад елемента колекція, який визначає, як підкроки повинні бути пов’язані з main/батьківський елемент крок за допомогою 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. Поточний стан можна визначити за допомогою викликаної властивості Output Steps.

Приклад коду (посилання з елемента SubwayNav керування):

Self.Steps

Приклад коду (з посиланням на кроки з іншого елемента керування):

SubwayNav1.Steps

Обмеження

Цей компонент коду можна використовувати лише в компонованих програмах і настроюваних сторінках.