Freigeben über

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.

Anmerkung

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

SubwayNav-Steuerelement.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz 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 des Office 365 Administrationssteuerelements SubwayNav bereit.

Wichtig

Ö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 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 Beschreibung
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 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, CompletedUnsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, SkippedWizardComplete
ItemDisabled Optional. Ob der Schritt deaktiviert ist.
ItemVisuallyDisabled Optional. Ob der Schritt visuell deaktiviert ist.

Zusätzliche Eigenschaften

Name Beschreibung
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

Einschränkungen

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

  • Last updated on