Compartilhar via

Controle Persona (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Um controle criado para exibir informações formatadas.

Observação

A documentação completa e o código-fonte são encontrados no repositório de componentes de código do GitHub.

Importante

  • Esse é um recurso de versão preliminar.
  • Os recursos em versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Controle Persona

Description

Uma persona é uma representação visual de uma pessoa em todos os produtos, normalmente mostrando a imagem que a pessoa carregou. O controle também pode ser usado para mostrar o status online dessa pessoa.

O controle completo tem o avatar de um indivíduo (uma imagem carregada ou uma composição das iniciais da pessoa em uma cor de fundo), seu nome ou identificação e status online.

O controle de persona é usado nos controles PeoplePicker e Facepile.

Este componente de código fornece um wrapper em torno do controle da Persona da Interface do Usuário do Fluent para uso em tela e páginas personalizadas. Consulte a documentação do componente para obter as melhores práticas.

Principais propriedades

Propriedade Description
ImageUrl URL para a imagem a ser usada. Use uma imagem com uma proporção quadrada e que seja grande o suficiente para caber na área da imagem.
ImageInitials As iniciais do usuário a serem exibidas na área da imagem quando não houver nenhuma imagem.
Text Texto principal a ser exibido, geralmente o nome da pessoa.
SecondaryText Texto secundário a ser exibido, geralmente a função do usuário.
TertiaryText Texto terciário a ser exibido, geralmente o status do usuário. O texto terciário é mostrado somente ao usar size72 ou size100.
OptionalText Texto opcional a ser exibido, geralmente uma mensagem personalizada definida. O texto opcional é mostrado somente ao usar size100.
ImageAlt Texto alternativo para a imagem.
HidePersonaDetails Especifica se os detalhes da persona não devem ser renderizados e renderiza apenas a imagem/iniciais da persona.
PersonaSize Tamanho da persona para ser exibida na tela.
Presence Presença da pessoa a ser exibida. A presença não será exibida se estiver indefinida. O valor pode ser: away, blocked, busy, dnd, none, offline ou online.

Propriedades de Estilo

Propriedade Description
Theme Aceita uma string JSON que é gerada usando Fluent UI Theme Designer (windows.net). Se for deixado em branco, o tema padrão definido pelo Power Apps é usado. Saiba mais sobre o tema.
AccessibilityLabel Rótulo aria do leitor de tela.

Exemplo

Aqui estão alguns valores de exemplo para o componente Persona:

Propriedade Valor
Text "Megan Brown"
SecondaryText "Engenheiro de software"
TertiaryText "Em reunião"
OptionalText "Disponível às 16h"
HidePersonaDetails falso
ImageUrl User().Image
PersonaSize PowerCAT.Persona.PersonaSize.Size100
Presence PowerCAT.Persona.Presence.Online

Limitações

Esse componente de tela só pode ser usado em aplicativos de tela e páginas personalizadas.

  • Last updated on