Partager via

Pivot contrôle

  • Article

Un contrôle utilisé pour assurer la navigation.

Note

La documentation complète et le code source sont accessibles dans le Référentiel de composants de code GitHub.

Contrôle Pivot.

Description

Le contrôle Pivot et le modèle d’onglets associés sont utilisés pour naviguer dans des catégories de contenu distinctes fréquemment consultées. Les contrôles Pivot permettent de naviguer entre deux ou plusieurs vues de contenu et s’appuient sur des en-têtes de texte pour articuler les différentes sections de contenu.

Ce composant de code fournit un wrapper autour du contrôle Pivot de Fluent UI à utiliser dans les applications canevas et les pages personnalisées.

Propriétés

Propriétés principales

Property Description
RenderType Type de contrôle à afficher.
SelectedKey La clé à sélectionner. Celle-ci sera mise à jour via l’événement OnChange lorsque l’utilisateur interagira avec le contrôle.
Items Les éléments d’action à afficher

Items propriétés

Chaque élément utilise le schéma suivant pour visualiser les données dans le composant.

Nom Description
ItemDisplayName Le nom d’affichage de l’élément de navigation
ItemKey Clé à utiliser pour indiquer quel élément est sélectionné et lors de l’ajout de sous-éléments. Les clés doivent être uniques.
ItemEnabled Définir sur false si l’option est désactivée
ItemVisible Définir sur false si l’option n’est pas visible
ItemChecked Définir sur true si l’option est cochée (par exemple, diviser les boutons dans une barre de commandes)
ItemIconName L’icône Fluent UI à utiliser (voir Icônes Fluent UI)
ItemCount Afficher un nombre d’éléments sur un lien d’élément Pivot (sélecteur de vue).

Exemple :

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

Propriétés du style

Property Description
Theme Accepte une chaîne JSON générée à l’aide du Concepteur de thème Fluent UI (windows.net). Si vous laissez ce champ vide, le thème par défaut défini par Power Apps sera utilisé. Consultez Création de thèmes pour obtenir des instructions de configuration.
RenderSize Le contrôle pivot peut être affiché en deux tailles (large/normal)
AccessibilityLabel Étiquette aria pour les lecteurs d’écran

Propriétés d’événement

Property Description
InputEvent Un événement à envoyer au contrôle. Par exemple, SetFocus. Voir ci-dessous.

Behavior

Prend en charge SetFocus en tant que InputEvent.

Configurer le comportement des onglets

Coordonnez les pages à onglets en associant la propriété Visible des composants dépendants de votre application (par exemple, un conteneur qui représente une page) avec la valeur de Pivot1.Selected.ItemKey.

Visible propriété d’un contrôle dépendant qui s’affiche lorsque la clé tabFile itemKey est sélectionnée :

Pivot1.Selected.ItemKey = "tabFile"

Limitations

Ce composant de code ne peut être utilisé que dans les applications canevas et les pages personnalisées.

Consultez d’autres notes de limitation dans la section Difficultés de conception de la documentation GitHub.