Delen via

SubwayNav controle (preview)

  • Artikel

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Een besturingselement dat wordt gebruikt om gebruikers door een proces te leiden.

Notitie

Volledige documentatie en broncode vindt u in de GitHub-opslagplaats voor codeonderdelen.

Besturingselement SubwayNav.

Belangrijk

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Beschrijving

Met het besturingselement SubwayNav kunt u de stappen visualiseren die nodig zijn voor een bepaalde wizard. De wizard is een onderdeel dat gebruikers begeleidt bij het voltooien van vooraf gedefinieerde stappen bij het uitvoeren van een instellings- of aanmaaktaak.

Dit codeonderdeel vormt een wrapper rond een gevorkte versie van het Office 365-besturingselement voor beheer SubwayNav.

Belangrijk

Open geen bugs bij het Admin Controls-team - stuur problemen altijd naar de Creator Kit Github Repository op aka.ms/creatorkit/bug.

Belangrijke eigenschappen

Meting Omschrijving
Items De tabel met weer te geven items (stappen) (zie tabelschema voor Items hieronder).
WizardCompleteorError Weergegeven als "SubwayNav-status"

Items tabel eigenschappen

Elk object in de invoertabel Items moet gebruikmaken van de volgende eigenschappen om correct te worden weergegeven:

Meting Beschrijving
ItemLabel Label voor de stap
ItemKey De toets die moet worden gebruikt om aan te geven welk item/welke stap is geselecteerd. De toetsen moeten uniek zijn.
ParentItemKey Optioneel. ItemKey van het bovenliggende element, gebruikt voor het weergeven van substappen.
ItemState Voor het specificeren van de status van de stap. De volgende ondersteunde statussen zijn beschikbaar:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, Skipped, WizardComplete
ItemDisabled Optioneel. Geeft aan of de stap is uitgeschakeld.
ItemVisuallyDisabled Optioneel. Geeft aan of de stap visueel is uitgeschakeld.

Aanvullende eigenschappen

Meting Beschrijving
AccessibilityLabel Arialabel voor schermlezers.
InputEvent Een gebeurtenis waarnaar het besturingselement moet worden verzonden Bijvoorbeeld SetFocus. Zie hieronder.
Theme Accepteert een JSON-tekenreeks die is gegenereerd met Ontwerper van Fluent UI Theme (windows.net). Als u dit leeg laat, wordt het standaardthema gebruikt dat door Power Apps is gedefinieerd.

Voorbeeld

  • Ondersteunt SetFocus als een InputEvent.

Voorbeeld van invoerverzamelingswaarde voor eigenschap 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" }
)

Gebruik de eigenschap OnSelect of OnChange van het besturingselement SubwayNav om de stap op te halen die is geselecteerd door de gebruiker.

Voorbeeldcode:

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

Voorbeeld van substapscenario's

Hieronder ziet u een voorbeeld van een itemverzameling waarin wordt gedefinieerd hoe substappen moeten worden gekoppeld aan de hoofd-/bovenliggende stap met behulp van 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" }
)

Uitvoerschema

De status van elk item (stap) verandert terwijl we een andere stap selecteren of naar een andere stap gaan die intern plaatsvindt, met name de Current & CurrentWithSubStep. De huidige status kan worden bepaald met de uitvoereigenschap genaamd Steps.

Voorbeeldcode (waarnaar wordt verwezen vanuit het besturingselement SubwayNav):

Self.Steps

Voorbeeldcode (waarmee wordt verwezen naar de stappen vanuit een ander besturingselement):

SubwayNav1.Steps

Beperkingen

Dit codeonderdeel kan alleen worden gebruikt in canvas-apps en aangepaste pagina's.