Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
[Este artigo inclui documentação pré-versão e está sujeito a alterações.]
Um controlo concebido para apresentar informações formatadas.
Nota
A documentação completa e o código de origem encontram-se no repositório de componentes de código do GitHub.
Importante
- Esta é uma caraterística de pré-visualização.
- As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.
Description
A persona é uma representação visual de uma pessoa entre produtos, normalmente, a mostrar a imagem que a pessoa carregou. O controlo também pode ser utilizado para mostrar o estado online dessa pessoa.
O controlo completo inclui o avatar de um indivíduo (uma imagem carregada ou uma composição das iniciais da pessoa numa cor de fundo), o respetivo nome ou identificação e o estado online.
O controlo persona é utilizado nos controlos PeoplePicker e Facepile.
Este componente de código fornece um wrapper em torno do controlo Persona do Fluent UI para utilização em telas e páginas personalizadas. Consulte a documentação de componentes para obter as melhores práticas.
Propriedades chave
| Property | Description |
|---|---|
ImageUrl |
URL para a imagem a utilizar. Use uma imagem com proporção quadrada e que seja grande o suficiente para caber na área da imagem. |
ImageInitials |
As iniciais do utilizador a apresentar na área de imagem quando não existe imagem. |
Text |
Texto primário a apresentar, normalmente, o nome da pessoa. |
SecondaryText |
Texto secundário a apresentar, normalmente, a função do utilizador. |
TertiaryText |
Texto terciário a apresentar, normalmente, o estado do utilizador. O texto terciário é mostrado apenas quando se usa size72 ou size100. |
OptionalText |
Texto opcional a apresentar, normalmente, um conjunto de mensagens personalizado. O texto opcional é mostrado apenas quando se usa size100. |
ImageAlt |
Texto alternativo para a imagem. |
HidePersonaDetails |
Especifica se não compor os detalhes da persona, e apenas compõe a imagem/iniciais da persona. |
PersonaSize |
Tamanho da persona a aparecer no ecrã. |
Presence |
Presença da pessoa a apresentar. A presença não é apresentada se estiver indefinido. O valor pode ser um de: away, blocked, busy, dnd, none, offline, or online. |
Propriedades de Estilo
| Property | Description |
|---|---|
Theme |
Aceita uma cadeia JSON que é gerada através do Estruturador de Teams da Fluent UI (windows.net). Se deixado em branco, será utilizado o tema predefinido definido pelo Power Apps. Mais informações sobre temas. |
AccessibilityLabel |
Etiqueta aria de leitor de ecrã. |
Exemplo
Eis alguns valores de exemplo para o componente Persona:
| Property | valor |
|---|---|
Text |
"Megan Brown" |
SecondaryText |
"Engenheiro de Software" |
TertiaryText |
"Em reunião" |
OptionalText |
"Disponível às 16:00" |
HidePersonaDetails |
false |
ImageUrl |
User().Image |
PersonaSize |
PowerCAT.Persona.PersonaSize.Size100 |
Presence |
PowerCAT.Persona.Presence.Online |
Limitações
Este componente de tela só pode ser utilizado em aplicações de tela e páginas personalizadas.