SubwayNav Ovládací prvok (ukážka)
[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]
Ovládací prvok používaný na sprevádzanie používateľov procesom.
Poznámka
Úplná dokumentácia a zdrojový kód sa nachádzajú v úložisku súčastí kódu GitHub.
Dôležité
- Toto je ukážková funkcia.
- Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.
Description
Ovládací SubwayNav
prvok umožňuje vizualizovať kroky potrebné pre daného sprievodcu. Sprievodca je súčasť, ktorá vedie používateľov k dokončeniu preddefinovaných krokov na dosiahnutie úlohy nastavenia alebo vytvorenia.
Táto súčasť kódu poskytuje obal okolo rozvetvenej verzie Office 365 ovládacieho prvku správcu SubwayNav
.
Dôležité
Neotvárajte chyby s tímom Admin Controls - vždy odosielajte problémy do repozitára Creator Kit Github na adrese aka.ms/creatorkit/bug.
Vlastnosti kľúča
Name | Description |
---|---|
Items |
Tabuľka položiek (krokov), ktoré sa majú vykresliť (pozri Items schému tabuľky nižšie). |
WizardCompleteorError |
Zobrazené ako "SubwayNav state" |
Items
Vlastnosti tabuľky
Každý objekt vo vstupnej Items
tabuľke musí na správne vykreslenie používať nasledujúce vlastnosti:
Name | Description |
---|---|
ItemLabel |
Označenie kroku |
ItemKey |
Kľúč, ktorý sa má použiť na označenie, ktorá položka/krok je vybratá. Kľúče musia byť jedinečné. |
ParentItemKey |
Voliteľné. ItemKey nadradenej položky, používa sa na vykresľovanie čiastkových krokov. |
ItemState |
Zadanie stavu kroku. K dispozícii sú nasledujúce podporované stavy:Current ,, NotStarted ,,,, Completed Unsaved ViewedNotCompleted Error CurrentWithSubSteps Skipped WizardComplete |
ItemDisabled |
Voliteľné. Či je krok zakázaný. |
ItemVisuallyDisabled |
Voliteľné. Či je krok vizuálne postihnutý. |
Ďalšie vlastnosti
Name | Description |
---|---|
AccessibilityLabel |
Označenie aria-label pre čítačky obrazovky. |
InputEvent |
Udalosť, ktorá sa má odoslať ovládaciemu prvku. Napr. SetFocus . Pozrite nižšie. |
Theme |
Akceptuje reťazec JSON, ktorý je vygenerovaný pomocou aplikácie Fluent UI Theme Designer (windows.net). Ak toto necháte prázdne, použije sa predvolený motív definovaný v Power Apps. |
Príklad
- Podporuje SetFocus ako
InputEvent
.
Príklad hodnoty kolekcie vstupov pre vlastnosť 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" }
)
Ak chcete, aby používateľ získal vybratý krok, použite OnSelect
vlastnosť alebo OnChange
ovládacieho prvku SubwayNav
.
Príklad kódu:
Notify( Concatenate(Self.Selected.ItemLabel, " selected and its status is ", Self.Selected.ItemState ));
Príklad scenárov čiastkových krokov
Nižšie je uvedený príklad ukážky kolekcie položiek, ktorý definuje, ako majú byť čiastkové kroky prepojené s hlavným alebo nadradeným krokom pomocou 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" }
)
Výstupná schéma
Stav každej položky (kroku) sa mení, keď vyberáme alebo prechádzame na iný krok, interne, najmä Current
CurrentWithSubStep
Aktuálny stav je možné určiť pomocou vyvolanej Steps
vlastnosti Výstup.
Príklad kódu (odkazovaný z ovládacieho prvku SubwayNav
):
Self.Steps
Príklad kódu (odkazovanie na kroky z iného ovládacieho prvku):
SubwayNav1.Steps
Obmedzenia
Tento komponent kódu je možné použiť iba v aplikáciách plátna a vlastných stránkach.