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.

Bemerkning

Full dokumentasjon og kildekode finnes i GitHub-kodekomponentrepositoriet.

SubwayNav-kontroll.

Viktig!

  • Dette er en evalueringsfunksjonalitet.
  • 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.

Description

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

Navn Description
ItemLabel Etikett for steget
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 Description
AccessibilityLabel Aria-etikett for skjermleser.
InputEvent En hendelse for å sende til 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.

  • Last updated on