[本文章是發行前版本文件，且隨時可能變更。]
一個用來顯示格式化資訊的控制項。
注意
完整的文件和原始程式碼可以在 GitHub 程式碼元件存放庫中找到。
重要
- 這是預覽功能。
- 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
描述
角色是跨產品的人物的視覺表現，通常顯示人物上傳的影像。 此控制項也可以用來顯示該人員的線上狀態。
完整的控制包括個人的頭像 (上傳的影像或在背景顏色上由個人名稱首字母組成的影像)、名稱或身分以及線上狀態。
persona 控制項用於 PeoplePicker 和 Facepile 控制項中。
此程式碼元件為 Fluent UI Persona 控制項提供了一個包裝函式，以便在畫布和自訂頁面中使用。 請參閱元件文件以了解最佳做法。
索引鍵屬性
| 屬性 | 描述 |
|---|---|
ImageUrl |
要使用的影像的 URL。 使用具有正方形長寬比且足夠大以適合影像區域的影像。 |
ImageInitials |
沒有圖像時，會在圖像區域顯示使用者的姓名縮寫。 |
Text |
要顯示的主要文字，通常是人員的名稱。 |
SecondaryText |
要顯示的次要文字，通常是使用者的角色。 |
TertiaryText |
要顯示的第三層文字，通常是使用者的狀態。 只有在使用 size72 或 size100 時才會顯示第三層文字。 |
OptionalText |
要顯示的選用文字，通常是自訂訊息組。 僅當使用 size100 時才會顯示可選文字。 |
ImageAlt |
影像的替代文字。 |
HidePersonaDetails |
指定是否不呈現角色詳細資訊，而僅呈現角色影像/首字母。 |
PersonaSize |
要顯示在螢幕上的角色大小。 |
Presence |
顯示人員的存在。 如果未定義，則不顯示存在。 該值可以是以下之一：away、blocked、busy、dnd、none、offline 或 online。 |
樣式屬性
| 屬性 | 描述 |
|---|---|
Theme |
接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 如果留空，則使用 Power Apps 定義的預設主題。 進一步了解主題。 |
AccessibilityLabel |
螢幕報讀軟體 aria-label。 |
範例
以下是 Persona 元件的一些範例值：
| 屬性 | 數值 |
|---|---|
Text |
「Megan Brown」 |
SecondaryText |
「軟體工程師」 |
TertiaryText |
「開會中」 |
OptionalText |
「下午 4 點有空」 |
HidePersonaDetails |
False |
ImageUrl |
User().Image |
PersonaSize |
PowerCAT.Persona.PersonaSize.Size100 |
Presence |
PowerCAT.Persona.Presence.Online |
限制
此畫布元件只能在畫布應用程式和自訂頁面中使用。