Del via

SubwayNav Kontrolelement (forhåndsversion)

  • Artikel

[Denne artikel er dokumentation til den foreløbige udgivelse. Der kan forekomme ændringer.]

Et kontrolelement, der bruges til at vejlede brugere gennem en proces.

Bemærk

Fuld dokumentation og kildekode fundet i GitHub-kodekomponenters lager.

SubwayNav-kontrolelement.

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Forhåndsversionsfunktioner er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Beskrivelse

Kontrolelementet SubwayNav giver dig mulighed for at visualisere de trin, der kræves for en bestemt guide. Guiden er en komponent, der hjælper brugere med at fuldføre foruddefinerede trin for at udføre en konfigurations- eller oprettelsesopgave.

Denne kodekomponent indeholder et ombryder om en forgrenet version af Office 365 Administration-kontrolelementet SubwayNav.

Vigtigt

Åbn ikke fejl med Admin Controls-teamet - indsend altid problemer til Creator Kit Github Repository på aka.ms/creatorkit/bug.

Nøgleegenskaber

Name Description
Items Den tabel over elementer (trin), der skal gengives (se tabelskemaet Items nedenfor).
WizardCompleteorError Vises som "tilstanden SubwayNav"

Items Egenskaber for tabel

De enkelte objekter i Items-inputtabellen skal bruge følgende egenskaber for at blive gengivet korrekt:

Navn Beskrivelse
ItemLabel Navn til trinnet
ItemKey Den nøgle, der skal bruges til at angive, hvilket element/trin der er valgt. Nøglerne skal være entydige.
ParentItemKey Valgfrit. ItemKey for den overordnede, der bruges til gengivelse af undertrin.
ItemState Angivelse af trinnets tilstand. Følgende tilgængelige statusser understøttes:
Current,,,,,, NotStarted, Completed,, Unsaved ViewedNotCompleted Error CurrentWithSubSteps Skipped WizardComplete
ItemDisabled Valgfrit. Om trinnet er deaktiveret.
ItemVisuallyDisabled Valgfrit. Om trinnet er deaktiveret visuelt.

Yderligere egenskaber

Navn Beskrivelse
AccessibilityLabel Aria-label til skærmlæsere.
InputEvent En hændelse, der skal sendes til kontrolelementet. F.eks. SetFocus. Se nedenfor.
Theme Accepterer en JSON-streng, der oprettes ved hjælp af Fluent UI Theme-designer (windows.net). Hvis du lader dette være tomt, vises standardtemaet, defineret af Power Apps.

Eksempel

  • Understøtter SetFocus som en InputEvent.

Eksempel på en værdi for inputsamling til egenskaben 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" }
)

Brug egenskaben OnSelect eller OnChange for kontrolelementet SubwayNav til at få det valgte trin af brugeren.

Kodeeksempel:

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

Eksempel på scenarier med undertrin

Nedenfor er der et eksempel på en samling af elementer, der definerer, hvordan undertrin skal knyttes til hoved-/overordnet trin ved hjælp af 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" }
)

Outputskema

Tilstand for hvert element (trin) ændres internt, når vi vælger eller flytter til forskellige trin, især Current og CurrentWithSubStep. Den aktuelle status kan bestemmes ved hjælp af Output-egenskaben kaldet Steps.

Eksempelkode (refereres fra kontrolelementet SubwayNav):

Self.Steps

Eksempelkode (henviser til trinnene fra et andet kontrolelement):

SubwayNav1.Steps

Begrænsninger

Denne kodekomponent kan kun bruges i lærredapps og brugerdefinerede sider.