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


SubwayNav контроль (предварительная версия)

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Элемент управления, используемый для пошаговых инструкций по выполнению процесса.

Заметка

Полная документация и исходный код находятся в разделе Репозиторий компонентов кода на GitHub.

Элемент управления.

Внимание

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Описание:

Элемент управления SubwayNav позволяет визуализировать шаги, необходимые для данного мастера. Мастер — это компонент, который позволяет пользователям выполнить задачи настройки или создания с помощью предопределенных шагов.

Этот компонент кода представляет собой оболочку для разветвленной версии Office 365 элемента управления администратора SubwayNav.

Внимание

Не сообщайте об ошибках в команду Admin Controls — всегда отправляйте проблемы в репозиторий Creator Kit Github по адресу aka.ms/creatorkit/bug.

Ключевые свойства

Полное имя Description
Items Таблица элементов (шагов) для отображения (см. Items схему таблицы ниже).
WizardCompleteorError Отображается как "состояние SubwayNav"

Items свойства таблицы

Каждый объект в таблице входных данных Items должен использовать следующие свойства для правильного отображения:

Полное имя Описание:
ItemLabel Метка для шага
ItemKey Клавиша, которая используется для указания того, какой элемент/шаг выбран. Клавиши должны быть уникальными.
ParentItemKey Необязательно. ItemKey родительского элемента, используемый для отображения подшагов.
ItemState Указание состояния шага. Доступны следующие поддерживаемые состояния:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps,< а14>, Skipped WizardComplete
ItemDisabled Необязательно. Определяет, отключен ли шаг.
ItemVisuallyDisabled Необязательно. Определяет, отключен ли шаг визуально.

Дополнительные свойства

Полное имя Описание:
AccessibilityLabel Подпись Aria для программы чтения с экрана.
InputEvent Событие, которое требуется отправить элементу управления. Например, SetFocus. См. ниже.
Theme Принимает строку JSON, сгенерированную с помощью Конструктора тем Fluent UI (windows.net). Если оставить это поле пустым, будет использоваться тема по умолчанию, определенная Power Apps.

Пример

  • Поддерживает SetFocus как InputEvent.

Пример значения коллекции входных данных для свойства "Элементы":

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 ));

Пример сценариев для подшагов

Ниже приведен пример коллекции элементов, который определяет, как подшаги должны быть связаны с основным/родительским шагом с помощью 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

Ограничения

Этот компонент кода можно использовать только в приложениях на основе холста и настраиваемых страницах.