SubwayNav Steuerelement (Vorschauversion)

[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.

Note

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

SubwayNav-Steuerelement.

Important

  • Dies ist eine Vorschaufunktion.
  • Vorschaufunktionen sind nicht für den Produktionsgebrauch gedacht und verfügen möglicherweise über eingeschränkte Funktionalität. Diese Features sind vor einer offiziellen Veröffentlichung verfügbar, damit Kunden frühzeitigen Zugriff erhalten und Feedback geben können.

Description

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 des Office 365 Administrationssteuerelements SubwayNav bereit.

Important

Öffnen Sie keine Fehlerberichte beim Admin-Kontroll-Team - geben Sie Probleme immer im GitHub-Repository des Creator Kits unter aka.ms/creatorkit/bug ein.

Schlüsseleigenschaften

Name Description
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 Description
ItemLabel Beschriftung für den Schritt
ItemKey Die zu verwendende Taste, um anzuzeigen, welches Element/welcher Schritt ausgewählt ist. Die Schlüssel müssen eindeutig sein.
ParentItemKey Wahlfrei. ItemKey des übergeordneten Elements, das zum Rendern von Unterschritten verwendet wird.
ItemState Definiert den Status des Schritts. Die folgenden Status sind verfügbar:
Current, NotStarted, CompletedUnsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, SkippedWizardComplete
ItemDisabled Wahlfrei. Ob der Schritt deaktiviert ist.
ItemVisuallyDisabled Wahlfrei. Ob der Schritt visuell deaktiviert ist.

Zusätzliche Eigenschaften

Name Description
AccessibilityLabel Aria-Beschriftung für den Screenreader.
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 Eigenschaft '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" }
)

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 Unterstufen-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 der 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

Limitations

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

  • Last updated on