Zdieľať cez

SubwayNav Ovládací prvok (ukážka)

  • Článok

[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.

Ovládanie SubwayNav.

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,,,, CompletedUnsavedViewedNotCompletedErrorCurrentWithSubStepsSkippedWizardComplete
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

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ä CurrentCurrentWithSubStep 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.