[この記事はプレリリース ドキュメントであり、変更されることがあります。]
フォーマットされた情報を表示するように設計されたコントロール。
メモ
完全なドキュメントとソース コードは、 GitHub コード コンポーネント リポジトリにあります。
重要
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
Description
ペルソナは、製品全体の人物を視覚的に表現したものです。通常は、アップロードされたユーザーの画像が表示されます。 コントロールを使用して、その人のオンライン ステータスを表示することもできます。
完全なコントロールには、個人のアバター (アップロードされた画像または背景色での人物のイニシャルの合成)、名前または ID、およびオンライン状態が含まれます。
ペルソナ コントロールは、PeoplePicker と Facepile コントロールで使用します。
このコード コンポーネントは、キャンバス & カスタム ページで使用するための Fluent UI Persona コントロールのラッパーを提供します。 ベスト プラクティスについては、コンポーネントのドキュメントを参照してください。
重要なプロパティ
| プロパティ | Description |
|---|---|
ImageUrl |
使用する画像の URL。 正方形の縦横比を持ち、画像領域に収まる十分な大きさの画像を使用します。 |
ImageInitials |
画像がない場合に画像領域に表示するユーザーのイニシャル。 |
Text |
表示するプライマリ テキスト。通常は人の名前です。 |
SecondaryText |
表示する二次テキスト。通常はユーザーの役割です。 |
TertiaryText |
表示する 3 つ目のテキスト。通常はユーザーの状態です。 3 番目のテキストは、size72 または size100 を使用している場合にのみ表示されます。 |
OptionalText |
表示するオプションのテキスト。通常はカスタム メッセージ セットです。 省略可能なテキストは、size100 を使用する場合にのみ表示されます。 |
ImageAlt |
画像の代替テキスト。 |
HidePersonaDetails |
ペルソナの詳細をレンダリングせず、ペルソナイメージ/イニシャルだけをレンダリングするかどうかを指定します。 |
PersonaSize |
スクリーンに表示されるペルソナのサイズ。 |
Presence |
表示する人のプレゼンスです。 未定義の場合、プレゼンスは表示されません。 値には、 away、 blocked、 busy、 dnd、 none、 offline、または onlineのいずれかを指定できます。 |
スタイル プロパティ
| プロパティ | Description |
|---|---|
Theme |
Fluent UI テーマ デザイナー (windows.net) を使用して生成された JSON 文字列を受け入れます。 空白のままにすると、Power Apps で定義されている既定のテーマが使用されます。 テーマについて詳しくは、こちらをご覧ください。 |
AccessibilityLabel |
スクリーン リーダーの aria-ラベル。 |
例
Persona コンポーネントの値の例を次に示します。
| プロパティ | 価値 |
|---|---|
Text |
"Megan Brown" |
SecondaryText |
"ソフトウェア エンジニア" |
TertiaryText |
"会議中" |
OptionalText |
"4 時に戻ります" |
HidePersonaDetails |
偽 |
ImageUrl |
User().Image |
PersonaSize |
PowerCAT.Persona.PersonaSize.Size100 |
Presence |
PowerCAT.Persona.Presence.Online |
制限
このキャンバス コンポーネントは、キャンバス アプリとカスタム ページでのみ使用できます。