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 |
Обмеження
Цей компонент полотна можна використовувати лише в компонованих програмах і настроюваних сторінках.