SubwayNav-kontroll (forhåndsversjon)

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

En kontroll som brukes til å veilede brukere gjennom en fremgangsmåte.

Merk

Full dokumentasjons- og kildekode funnet i GitHub-kodekomponentrepositoriet.

Viktig

• Dette er en forhåndsversjonsfunksjon.
• Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemelding.

Bekrivelse

Med SubwayNav-kontrollen kan du visualisere trinnene som kreves for en gitt veiviser. Veiviseren er en komponent som veileder brukere i fullføringen av forhåndsdefinerte trinn i en konfigurasjons- eller opprettingsoppgave.

Denne kodekomponenten sørger for en wrapper rundt en forgrenet versjon av Office 365-administratorkontrollen SubwayNav.

Viktig

Ikke åpne feil med administratorkontrollteamet - send alltid problemer til GitHub-lageret for oppretterpakken på aka.ms/creatorkit/bug.

Nøkkelegenskaper

Name	Description
Items	Tabellen for elementer (trinn) som skal gjengis (se tabellskjemaet Items nedenfor).
WizardCompleteorError	Vises som «SubwayNav-tilstand»

Egenskaper for Items-tabellen

Hvert objekt i inndatatabellen Items må bruke følgende egenskaper for å gjengis riktig:

Name	Bekrivelse
ItemLabel	Etikett for trinnet
ItemKey	Nøkkelen som skal brukes til å angi hvilket element/trinn som er valgt. Nøklene må være unikt.
ParentItemKey	Valgfritt. ItemKey for overordnet, som brukes til å gjengi deltrinn.
ItemState	Angir tilstanden til trinnet. Følgende støttede tilstander er tilgjengelige: Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, Skipped, WizardComplete
ItemDisabled	Valgfritt. Hvorvidt trinnet er deaktivert.
ItemVisuallyDisabled	Valgfritt. Hvorvidt trinnet er visuelt deaktivert.

Tilleggsegenskaper

Name	Bekrivelse
AccessibilityLabel	Aria-etikett for skjermleser.
InputEvent	En hendelse for å sende kontrollen. For eksempel SetFocus. Se nedenfor.
Theme	Godtar en JSON-streng som genereres ved hjelp av Fluent UI Theme Designer (windows.net). Hvis du lar dette stå tomt, bruker du standardtemaet definert av Power Apps.

Eksempel

• Støtter SetFocus som en InputEvent.

Eksempel på inndatasamlingsverdi for egenskapen 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" }
)

Du kan hente trinnet brukeren har valgt, ved å bruke egenskapen OnSelect eller OnChange for SubwayNav-kontrollen.

Kodeeksempel:

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

Eksempel på deltrinnscenarioer

Nedenfor er et elementsamlingseksempel som definerer hvordan deltrinn må kobles til hovedtrinn / overordnet trinn ved hjelp av 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" }
)

Utdataskjema

Tilstanden til hvert element (trinn) endres internt når vi velger eller går til et annet trinn, særlig Current og CurrentWithSubStep. Gjeldende status kan fastsettes ved hjelp av utdataegenskapen kalt Steps.

Eksempelkode (som refereres til fra SubwayNav-kontrollen):

Self.Steps

Kodeeksempel (med referanse til trinnene fra en annen kontroll):

SubwayNav1.Steps

Begrensninger

Denne kodekomponenten kan bare brukes i lerretsapper og egendefinerte sider.