Condividi tramite

SubwayNav controllo (anteprima)

  • Articolo

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Un controllo utilizzato per guidare gli utenti attraverso un processo.

Nota

Documentazione e codice sorgente sono disponibili nel repository dei componenti del codice GitHub.

Controllo SubwayNav.

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.

Description

Il controllo SubwayNav consente di visualizzare i passaggi necessari per una determinata procedura guidata. Il wizard è un componente che guida gli utenti nel completamento dei passaggi predefiniti per eseguire un'attività di installazione o creazione.

Questo componente di codice fornisce un wrapper attorno a una versione sottoposta a forking del Controllo amministratore Office 365SubwayNav.

Importante

Non aprire bug con il team dei controlli amministrativi : invia sempre i problemi al repository Github del Creator Kit all'indirizzo aka.ms/creatorkit/bug.

Proprietà chiave

Name Description
Items La tabella degli elementi (passaggi) da visualizzare (vedi schema della tabella Items di seguito).
WizardCompleteorError Visualizzato come "Stato SubwayNav"

Items proprietà della tabella

Ciascun oggetto nella tabella di input Items deve utilizzare le seguenti proprietà per essere visualizzato correttamente:

Name Description
ItemLabel Etichetta per il passaggio
ItemKey Il tasto da utilizzare per indicare quale elemento/passaggio è selezionato. I tasti devono essere univoci.
ParentItemKey (Facoltativo). ItemKey dell'elemento padre, utilizzato per il rendering dei passaggi secondari.
ItemState Specificare lo stato del passaggio. Sono disponibili gli stati supportati seguenti:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, Skipped, WizardComplete
ItemDisabled (Facoltativo). Se il passaggio è disabilitato.
ItemVisuallyDisabled (Facoltativo). Se il passaggio è visivamente disabilitato.

Proprietà aggiuntive

Name Description
AccessibilityLabel Etichetta aria per utilità per la lettura dello schermo.
InputEvent Evento da inviare al controllo. Ad esempio, SetFocus. Vedere di seguito.
Theme Accetta una stringa JSON generata utilizzando la finestra di progettazione del tema dell'interfaccia utente Fluent (windows.net). Lasciare questo vuoto comporterà l'utilizzo del tema predefinito definito da Power Apps.

Esempio

Esempio di valore della raccolta di input per la proprietà 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 ottenere il passaggio selezionato dall'utente, utilizzare la proprietà OnSelect o OnChange del controllo SubwayNav.

Codice di esempio:

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

Esempio di scenari di passaggi secondari

Di seguito è riportato un esempio di raccolta di elementi di esempio che definisce in che modo i passaggi secondari devono essere collegati al passaggio principale/padre utilizzando 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" }
)

Schema di output

Lo stato di ciascun elemento (passaggio) cambia mentre selezioniamo o passiamo a un passaggio diverso internamente, in particolare Current & CurrentWithSubStep.. Lo stato corrente può essere determinato utilizzando la proprietà Output denominata Steps.

Codice di esempio (a cui si fa riferimento dal controllo SubwayNav):

Self.Steps

Codice di esempio (che fa riferimento ai passaggi di un altro controllo):

SubwayNav1.Steps

Limiti

Questo componente di codice può essere usato solo nelle app canvas e nelle pagine personalizzate.