Freigeben über

Pivot-Steuerelement

Ein Steuerelement, das zur Bereitstellung der Navigation verwendet wird.

Notiz

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

Navigationssteuerungs-Steuerelement.

Beschreibung

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
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
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
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
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 der itemKey tabFile 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.

  • Last updated on