Comparteix a través de

SubwayNav control (versió preliminar)

  • Article

[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]

Un control utilitzat per guiar els usuaris a través d'un procés.

Nota

La documentació completa i el codi font es troben al repositori de components de codi de GitHub.

Control de SubwayNav.

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Descripció

El SubwayNav control permet visualitzar els passos necessaris per a un assistent determinat. L'auxiliar és un component que guia els usuaris per completar els passos predefinits per aconseguir una tasca de configuració o creació.

Aquest component de codi proporciona un embolcall al voltant d'una versió bifurcada del control d'administració Office 365 SubwayNav.

Important

No obriu errors amb l'equip de controls d'administració: sempre envieu problemes al repositori de Github del kit de creació a aka.ms/creatorkit / bug.

Propietats de la clau

Nom Descripció
Items La taula d'elements (passos) a representar (vegeu Items l'esquema de la taula a continuació).
WizardCompleteorError Es mostra com a "Estat de SubwayNav"

Items Propietats de la taula

Cada objecte de la taula d'entrada Items ha d'utilitzar les propietats següents per renderitzar-se correctament:

Nom Descripció
ItemLabel Etiqueta per al pas
ItemKey La clau que s'ha d'utilitzar per indicar quin ítem/pas està seleccionat. Les claus han de ser úniques.
ParentItemKey Opcional. ItemKey del pare, utilitzat per representar subpassos.
ItemState Especificació de l'estat del pas. Hi ha disponibles els estats admesos següents:
Current,,,,,, NotStarted, Completed Unsaved ViewedNotCompleted Error CurrentWithSubSteps Skipped WizardComplete
ItemDisabled Opcional. Si el pas està inhabilitat.
ItemVisuallyDisabled Opcional. Si el pas té una discapacitat visual.

Propietats addicionals

Nom Descripció
AccessibilityLabel Etiqueta aria de lector de pantalla.
InputEvent Una incidència que s'enviarà al control. per exemple, SetFocus. Vegeu sota.
Theme Accepta una cadena JSON generada mitjançant el Fluent UI Theme Designer (windows.net). Deixant aquest camp en blanc s'utilitzarà el tema per defecte definit per Power Apps.

Exemple

Exemple de valor de col·lecció d'entrada per a la propietat 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" }
)

Per obtenir el pas seleccionat per l'usuari, utilitzeu la OnSelect propietat o OnChange del SubwayNav control.

Codi d'exemple:

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

Exemple d'escenaris de subpas

A continuació es mostra un exemple de col·lecció d'elements d'exemple que defineix com s'han d'enllaçar els subpassos amb el pas principal/principal mitjançant 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" }
)

Esquema de sortida

L'estat de cada element (pas) canvia a mesura que seleccionem o passem a diferents pas passa internament, especialment el Current & CurrentWithSubStep. L'estat actual es pot determinar mitjançant la propietat Output cridada Steps.

Codi d'exemple (referenciat des del SubwayNav control):

Self.Steps

Codi d'exemple (fent referència als passos d'un altre control):

SubwayNav1.Steps

Limitacions

Aquest codi del llenç només es pot utilitzar a les aplicacions del llenç i a les pàgines personalitzades.