Partager via


Contrôle Persona (version préliminaire)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Champ conçu pour afficher des informations formatées.

Note

La documentation complète et le code source se trouvent dans le référentiel des composants de code GitHub.

Important

  • Cette fonctionnalité est une fonctionnalité en version préliminaire.
  • Les fonctionnalités d'évaluation ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une version officielle afin que les clients puissent obtenir un accès anticipé et fournir des commentaires.

Contrôle Persona

Description

Un personnage est une représentation visuelle d’une personne à travers les produits, mettant généralement en valeur l’image que la personne a chargée. Le contrôle peut également être utilisé pour afficher le statut en ligne de cette personne.

Le contrôle complet inclut l’avatar d’un individu (image chargée ou composition des initiales de la personne sur une couleur d’arrière-plan), son nom ou son identification et son état en ligne.

Le contrôle Persona est utilisé dans les contrôles PeoplePicker et Facepile.

Ce composant de code fournit un wrapper autour du contrôle Personnage Fluent UI à utiliser dans les applications canevas et les pages personnalisées. Consultez la documentation du composant pour connaître les meilleures pratiques.

Propriétés principales

Propriété Description
ImageUrl URL de l’image à utiliser. Utilisez une image avec un rapport d’aspect carré et est suffisamment grande pour s’adapter à la zone d’image.
ImageInitials Les initiales de l’utilisateur à afficher dans la zone d’image lorsqu’il n’y a pas d’image.
Text Texte principal à afficher, généralement le nom de la personne.
SecondaryText Texte secondaire à afficher, généralement le rôle de l’utilisateur.
TertiaryText Texte tertiaire à afficher, généralement le statut de l’utilisateur. Le texte tertiaire est affiché uniquement lors de l’utilisation de la taille72 ou de la taille100.
OptionalText Texte facultatif à afficher, généralement un ensemble de messages personnalisés. Le texte facultatif est affiché uniquement lors de l’utilisation de la taille100.
ImageAlt Texte de remplacement de l’image.
HidePersonaDetails Spécifie s’il ne faut pas afficher les détails de persona et afficher simplement l’image/initiale de persona.
PersonaSize Taille du personnage à afficher à l’écran.
Presence Présence de la personne à afficher. La présence n’est pas affichée si elle n’est pas définie. La valeur peut être l’une des suivantes : away, , blockedbusy, dnd, none, offline, ou online.

Propriétés de style

Propriété Description
Theme Accepte une chaîne JSON générée à l’aide du Concepteur de thème Fluent UI (windows.net). Si elle est vide, le thème par défaut défini par Power Apps est utilisé. En savoir plus sur les thèmes.
AccessibilityLabel Lecteur d’écran aria-label.

Exemple

Voici quelques exemples de valeurs pour le composant Persona :

Propriété active
Text « Megan Brown »
SecondaryText « Ingénieur logiciel »
TertiaryText « En réunion »
OptionalText « Disponible à 16h00 »
HidePersonaDetails faux
ImageUrl User().Image
PersonaSize PowerCAT.Persona.PersonaSize.Size100
Presence PowerCAT.Persona.Presence.Online

Limitations

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