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.

Notat

Full dokumentasjon og kildekode finnes i GitHub-kodekomponentrepositoriet.

SubwayNav-kontroll.

Viktig!

  • Dette er en forhåndsvisningsfunksjon.
  • Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

Beskrivelse

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 gir en innpakning rundt en forgrenet versjon av Office 365 Admin Control 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

Navn Beskrivelse
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:

Navn Beskrivelse
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. Elementnøkkel for det overordnede, brukt for å gjengi deltrinn.
ItemState Angir tilstanden til trinnet. Følgende støttede tilstander er tilgjengelige:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, , SkippedWizardComplete
ItemDisabled Valgfritt. Hvorvidt trinnet er deaktivert.
ItemVisuallyDisabled Valgfritt. Hvorvidt trinnet er visuelt deaktivert.

Tilleggsegenskaper

Navn Beskrivelse
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

Limitations

Denne kodekomponenten kan bare brukes i lerretsapper og egendefinerte sider.

  • Last updated on