Del via

SubwayNav Kontroll (forhåndsversjon)

  • Artikkel

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

SubwayNav-kontroll.

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 Admin Controls-teamet – send alltid inn problemer til Creator Kit Github Repository 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»

Items Egenskaper for tabell

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

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.