Pivot Kontrolle

Ein Steuerelement, das zur Bereitstellung der Navigation verwendet wird.

Notiz

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

Beschreibung des Dataflows

Das Pivot-Steuerelement und verwandte Registerkartenmuster werden zum Navigieren in häufig aufgerufenen, unterschiedlichen Inhaltskategorien verwendet. Navigationssteuerungen ermöglichen die Navigation zwischen zwei oder mehr Inhaltsansichten und stützen sich auf Textkopfzeilen, um die verschiedenen Inhaltsabschnitte zu artikulieren.

Diese Codekomponente stellt einen Wrapper um das Fluent-Benutzeroberfläche Pivot-Steuerelement zur Verwendung in Canvas-Apps und benutzerdefinierten Seiten bereit.

Eigenschaften

Schlüsseleigenschaften

Eigenschaften	Beschreibung des Dataflows
RenderType	Der Typ des Steuerelements, in das gerendert werden soll.
SelectedKey	Der auszuwählende Schlüssel Dies wird über das OnChange-Ereignis aktualisiert, wenn der Benutzer mit dem Steuerelement interagiert.
Items	Die zu rendernden Aktionselemente

Items Eigenschaften

Jedes Element verwendet das folgende Schema, um Daten in der Komponente zu visualisieren.

Name des Dataflows	Beschreibung des Dataflows
ItemDisplayName	Der Anzeigename des Navigationselements
ItemKey	Die zu verwendende Taste, um anzuzeigen, welches Element ausgewählt ist, und wenn Unterelemente hinzugefügt werden. Die Tasten müssen eindeutig sein.
ItemEnabled	Auf „False“ setzen, wenn die Option deaktiviert ist
ItemVisible	Auf „False“ setzen, wenn die Option nicht sichtbar ist
ItemChecked	Auf „True“ setzen, wenn die Option aktiviert ist (z. B. geteilte Schaltflächen in einer Befehlsleiste)
ItemIconName	Das zu verwendende Fluent-UI-Symbol (siehe Fluent-UI-Symbole)
ItemCount	Zeigen Sie eine Elementanzahl auf einem Pivot-Element-Link an.

Beispiel:

Table(
  {
      ItemKey: "tabFile",
      ItemDisplayName: "File"
  },
  {
      ItemKey: "tabHome",
      ItemDisplayName: "Home"
  },
  {
      ItemKey: "tabView",
      ItemDisplayName: "View"
  },
  {
      ItemKey: "tabAction",
      ItemDisplayName: "Action"
  }
)

Stileigenschaften

Eigenschaften	Beschreibung des Dataflows
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. Siehe Designs für eine Konfigurationsanleitung.
RenderSize	Das Pivot-Steuerelement kann in zwei Größen gerendert werden (groß/normal).
AccessibilityLabel	Aria-Beschriftung für Sprachausgabe

Ereigniseigenschaften

Eigenschaften	Beschreibung des Dataflows
InputEvent	Ein Ereignis, das an das Steuerelement gesendet werden soll. z. B. SetFocus. Siehe unten.

Behavior

Unterstützt SetFocus als InputEvent.

Registerkartenverhalten konfigurieren

Koordinieren Sie Registerkarten, indem Sie die Visible-Eigenschaft abhängiger Komponenten in Ihrer App (z. B. einen Container, der eine Seite darstellt) mit dem Wert von Pivot1.Selected.ItemKey verknüpfen.

Visible Eigenschaft eines abhängigen Steuerelements, die angezeigt wird, wenn tabFile itemKey ausgewählt ist:

Pivot1.Selected.ItemKey = "tabFile"

Einschränkungen

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

Weitere Hinweise auf Einschränkungen finden Sie im Abschnitt zu gestalterischen Herausforderungen der GitHub-Dokumentation.