ملاحظة
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]
عنصر تحكم مصمم لعرض المعلومات المنسقة.
ملاحظة
يمكن العثور على الوثائق الكاملة والتعليمات البرمجية المصدر في مستودع مكونات التعليمات البرمجية في 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 |
يقبل سلسلة JSON التي يتم إنشاؤها باستخدام مصمم نسق Fluent UI (windows.net). سيؤدي ترك هذا الخيار فارغًا إلى استخدام النسق الافتراضي المحدد بواسطة Power Apps. راجع النسق للحصول على إرشادات حول كيفية التكوين. |
AccessibilityLabel |
aria-label قارئ الشاشة |
مثال
فيما يلي بعض الأمثلة على القيم التي يمكن استخدامها في مكون Persona:
| الخاصية | القيمة |
|---|---|
Text |
"ميغان براون" |
SecondaryText |
"مهندس برامج" |
TertiaryText |
"في اجتماع" |
OptionalText |
"متوفر الساعة 4:00 مساءً" |
HidePersonaDetails |
true |
ImageUrl |
User().Image |
PersonaSize |
PowerCAT.Persona.PersonaSize.Size100 |
Presence |
PowerCAT.Persona.Presence.Online |
القيود
لا يمكن استخدام مكون اللوحة هذا إلا في تطبيقات اللوحة والصفحات المخصصة.