Dela via

SubwayNav Kontroll (förhandsversion)

  • Artikel

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

En kontroll som används för att guida användare genom en process.

Kommentar

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

SubwayNav-kontroll.

Viktigt!

  • Detta är en förhandsversion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

Description

Kontrollen SubwayNav gör att du kan visualisera de steg som krävs för en viss guide. Guiden är en komponent som guidar användarna till att slutföra fördefinierade steg för att utföra en konfigurations- eller skapandeuppgift.

Den här kodkomponenten skapar reglagen runt en förgrenad version av Office 365 administratörskontrollen SubwayNav.

Viktigt!

Öppna inte buggar med Admin Controls-teamet - skicka alltid in problem till Creator Kit Github Repository på aka.ms/creatorkit/bugg.

Nyckelegenskaper

Name Description
Items Tabellen med objekt (steg) som ska återges (se Items tabellschemat nedan).
WizardCompleteorError Visas som "SubwayNav-status"

Items Egenskaper för tabell

För varje objekt i indatatabellen Items måste följande egenskaper användas för att återge korrekt:

Name Description
ItemLabel Etikett för steget
ItemKey Den nyckel som ska användas för att ange vilket objekt/steg som har markerats. Nycklarna måste vara unika.
ParentItemKey Valfritt. ItemKey för den överordnade som används för återgivning av understeg.
ItemState Anger stegets tillstånd. Följande tillstånd som stöds är tillgängliga:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps Skipped WizardComplete
ItemDisabled Valfritt. Om steget är inaktiverat.
ItemVisuallyDisabled Valfritt. Om steget är visuellt inaktiverat.

Ytterligare egenskaper

Name Description
AccessibilityLabel Aria-etikett för skärmläsare.
InputEvent En händelse att skicka till kontrollen. t.ex. SetFocus. Se nedan.
Theme Godkänner en JSON-sträng som genereras med Fluent UI temadesigner (windows.net). Om du lämnar detta tomt används standardstandarden som definieras av Power Apps.

Exempel

Exempel på indatasamlingsvärde för egenskapen Objekt:

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" }
)

För att få det valda steget av användaren, använd OnSelect eller OnChange egenskapen för kontrollen SubwayNav.

Exempelkod:

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

Exempel för understegsscenarier

Nedan följer ett exempel på exempel på objektsamling som definierar hur understeg måste länkas till huvud-/överordnat steg med hjälp 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" }
)

Utdataschema

Tillståndet för varje objekt (steg) ändras när vi väljer eller flyttar till olika steg sker internt, särskilt för Current & CurrentWithSubStep. Aktuell status kan fastställas med hjälp av egenskapen Utdata Steps.

Exempelkod (refereras från SubwayNav kontrollen):

Self.Steps

Exempelkod (refererar till stegen från en annan kontroll):

SubwayNav1.Steps

Begränsningar

Den här kodkomponenten kan endast användas i arbetsyteappar och anpassade sidor.