Freigeben über

SubwayNav Kontrolle (Vorschauversion)

  • Artikel

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Ein Steuerelement, das verwendet wird, um Benutzer durch einen Prozess zu führen.

Anmerkung

Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.

SubwayNav-Steuerelement.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschau sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Beschreibung

Mit dem SubwayNav Steuerelement können Sie die Schritte visualisieren, die für einen bestimmten Assistenten erforderlich sind. Der Assistent ist eine Komponente, die Benutzer anleitet, vordefinierte Schritte auszuführen, um eine Einrichtungs- oder Erstellungsaufgabe zu erfüllen.

Diese Codekomponente stellt einen Wrapper um eine gegabelte Version der Office 365 Admin-Steuerung SubwayNav bereit.

Wichtig

Melden Sie Fehler nicht dem Admin Controls-Team . Senden Sie Probleme immer an das Creator Kit Github Repository unter aka.ms/creatorkit/bug.

Schlüsseleigenschaften

Name des Dataflows Beschreibung
Items Die Tabelle der zu rendernden Elemente (Schritte) (siehe Items Tabellenschema unten).
WizardCompleteorError Angezeigt als „SubwayNav-Status“

Items Tabelleneigenschaften

Jedes Objekt in der Items Eingabetabelle muss die folgenden Eigenschaften verwenden, um korrekt wiedergegeben zu werden:

Name des Dataflows Beschreibung
ItemLabel Beschriftung für den Schritt
ItemKey Die zu verwendende Taste, um anzuzeigen, welches Element/welcher Schritt ausgewählt ist. Die Tasten müssen eindeutig sein.
ParentItemKey Optional. ItemKey des übergeordneten Elements, das zum Rendern von Unterschritten verwendet wird.
ItemState Definiert den Status des Schritts. Die folgenden Stati sind verfügbar:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, Skipped, WizardComplete
ItemDisabled Optional. Ob der Schritt deaktiviert ist.
ItemVisuallyDisabled Optional. Ob der Schritt visuell deaktiviert ist.

Zusätzliche Eigenschaften

Name des Dataflows Beschreibung
AccessibilityLabel Aria-Beschriftung für Sprachausgabe.
InputEvent Ein Ereignis, das an das Steuerelement gesendet werden soll. z. B. SetFocus. Siehe unten.
Theme Akzeptiert eine JSON-Zeichenfolge, die mithilfe des Fluent-UI-Themen-Designers (windows.net) generiert wird. Wenn Sie dieses Feld leer lassen, wird das in Power Apps definierte Standarddesign verwendet.

Beispiel

Beispiel für einen Eingabesammlungswert für die Element-Eigenschaft:

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

Um den vom Benutzer ausgewählten Schritt abzurufen, verwenden Sie die OnSelect oder OnChange Eigenschaft des SubwayNav Steuerelements.

Codebeispiel:

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

Beispiel für Unterschritt-Szenarien

Nachfolgend finden Sie ein Beispiel für eine Elementsammlung, das definiert, wie Unterschritte mithilfe von ParentItemKey mit dem Haupt-/übergeordneten Schritt verknüpft werden müssen.

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

Ausgabeschema

Der Status jedes Elements (Schritt) ändert sich, wenn wir einen anderen Schritt auswählen oder zu einem anderen wechseln, was intern geschieht, insbesondere Current & CurrentWithSubStep. Der aktuelle Status kann mithilfe der Ausgabeeigenschaft namens Steps ermittelt werden.

Beispielcode (auf den vom SubwayNav-Steuerelement verwiesen wird):

Self.Steps

Beispielcode (der auf die Schritte eines anderen Steuerelements verweist):

SubwayNav1.Steps

Einschränkungen

Diese Codekomponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.