Поділитися через


Persona control (підготовча версія)

[Ця стаття стосується попередньої версії, і її буде змінено.]

Елемент керування для відображення відформатованих відомостей.

Нотатка

Повна документація та вихідний код із репозиторію компонентів коду GitHub.

Важливо

  • Це функція попереднього перегляду.
  • Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Управління персонами

Опис

Портрет — це візуальне представлення особи в продуктах, яке зазвичай демонструє зображення, вибране й передане особою. Елемент керування також можна використовувати для відображення стану присутності цієї особи.

Повний елемент керування включає в себе аватар особи (завантажене зображення або ініціали особи на кольоровому фоні), ім’я або ідентифікатор, а також стан присутності.

Елемент керування Persona («Портрет») використовується в елементах керування PeoplePicker і Facepile .

Цей компонент коду надає обгортку навколо елемента керування Fluent UI Persona для використання на полотні та користувацьких сторінках. Див. документацію компонента для отримання рекомендацій.

Ключові властивості

Властивість Опис
ImageUrl URL-адреса зображення, що використовується; повинно бути квадратним і досить великим, щоб уміститися в область зображення.
ImageInitials Ініціали користувача, які відображаються в області зображення, якщо зображення відсутнє.
Text Основний текст для відображення, зазвичай це ім’я особи.
SecondaryText Допоміжний текст для відображення, зазвичай це роль користувача.
TertiaryText Текст третього порядку для відображення, зазвичай це стан користувача. Текст третього порядку буде відображатися тільки при використанні розмірів 72 або 100 (size72 або size100).
OptionalText Необов’язковий текст для відображення, зазвичай настроюваний набір повідомлень. Необов'язковий текст буде відображатися тільки при використанні розміру 100 (size100).
ImageAlt Текст заміщення для зображення.
HidePersonaDetails Чи слід вимкнути відображення відомостей про особу і просто виводити зображення або ініціали особи.
PersonaSize Розмір портрета, який відображатиметься на екрані.
Presence Присутність особи, що відображатиметься — присутність не відображатиметься, якщо не визначено. Дозволені такі значення: away, blocked busy, dnd, none, offline online

Властивості стилю

Властивість Опис
Theme Приймає рядок JSON, створений за допомогою конструктора тем Fluent UI (windows.net). Якщо залишити це значення пустим, використовуватиметься тема, визначена Power Apps. Див. використання тем, щоб отримати вказівки щодо налаштування.
AccessibilityLabel Підпис aria-label для невізуальних екранів

Приклад

Нижче наведено кілька прикладів значень, які можна використовувати в компоненті «Портрет».

Властивість Значення
Text «Меґан Браун»
SecondaryText «Інженер програмного забезпечення»
TertiaryText «На зустрічі»
OptionalText «Буду о 16:00»
HidePersonaDetails хибність
ImageUrl User().Image
PersonaSize PowerCAT.Persona.PersonaSize.Size100
Presence PowerCAT.Persona.Presence.Online

Обмеження

Цей компонент полотна можна використовувати лише в компонованих програмах і настроюваних сторінках.