نصائح لإمكانية الوصول لبطاقات الموائمة المفتوحة

تعمل برامج Copilot Studio بشكل جيد مع قارئات الشاشة على نظام التشغيل Windows، مثل NonVisual Desktop Access ‏(NVDA) وJob Access with Speech ‏(JAWS). لتحسين إمكانية الوصول، ضع هذه النصائح في اعتبارك.

قارئات الشاشة

بالنسبة لسهولة الوصول إلى قارئ الشاشة والتنقل عبر لوحة المفاتيح في البطاقات الموائمة المفتوحة، إليك ما هو الأهم.

• دائماً قم بتضمين خاصية "التسمية": خاصية "التسمية" هي ما تعلنه قارئات الشاشة عندما يركز المستخدم على حقل الإدخال. بدونه، قد ينطق قارئ الشاشة عبارة "تعديل حقل" بدون سياق. غالبًا لا يقرأ قارئ الشاشة النص المؤقت، كما أنه يختفي بمجرد أن يبدأ المستخدم في الكتابة. لذا، تجنب الاعتماد عليهم لدعم إمكانية الوصول.

  {
    "type": "Input.Text",
    "id": "middleName",
    "label": "Middle name (optional)",
    "placeholder": "Enter your middle name"
  }
  

• استخدم "inputStyle" و"style" بعناية: تجنب التنسيق المخصص الذي يزيل مؤشرات التركيز. حلقة التركيز الافتراضية هي التي يعتمد عليها مستخدمو لوحة المفاتيح لمعرفة مكانهم على بطاقة.

• استخدم "isRequired" و"errorMessage" لقراء الْشاشة: حتى بالْنسبة للحقول الْاختيارية، يساعد "errorMessage" الْواضح برامج قراءة الْشاشة على توصيل ملاحظات الْتحقق مِنْ الْصحة.

  {
    "type": "Input.Text",
    "id": "middleName",
    "label": "Middle name (optional)",
    "isRequired": false,
    "errorMessage": "Please enter a valid middle name"
  }
  

• ترتيب علامات التبويب المنطقية: تتبع البطاقات الموائمة المفتوحة ترتيب نموذج كائن المستند (DOM) للتنقل بين علامات التبويب، لذا قم بتنظيم تمثيل JSON لبطاقتك بالترتيب الذي تريد أن ينتقل المستخدمون من خلاله باستخدام علامات التبويب. تجنب استخدام تخطيطات "ColumnSet" التي تُنشئ ترتيبًا منطقيًا بصريًا ولكنها تُسبب ترتيبًا مربكًا لعلامات التبويب لمستخدمي لوحة المفاتيح.

• أزرار الإجراءات يمكن الوصول إليها عبر لوحة المفاتيح بشكل افتراضي: خصائص مثل "Action.Submit" و"Action.OpenUrl" قابلة للتركيز بشكل أصلي. تأكد من أن العنوان وصفي وليس غامضًا مثل "اضغط هنا"، لأن قارئات الشاشة تنطق العنوان بصوت واضح.

• أضف "type": "TextBlock" للتعليمات: إذا كان قسم الحقول الاختيارية يحتاج إلى سياق، قم بتعيين "النوع" كـ "TextBlock" قبل تلك الحقول. تقرأ قارئات الشاشة الحقول واحدة تلو الأخرى، مما يوفر للمستخدمين السياق المطلوب قبل التفاعل مع المدخلات.

  {
    "type": "TextBlock",
    "text": "The following fields are optional. You can skip them if not applicable.",
    "wrap": true
  }
  

• تجنب استخدام "isVisible": استخدم "false" في سيناريوهات إمكانية الوصول: تتجاهل برامج قراءة الشاشة العناصر المخفية تمامًا. إذا كانت إمكانية الوصول هي الأولوية، أبقِ الحقول الاختيارية ظاهرة. إذا كان عليك إخفاؤها، تأكد من أن التبديل يحمل تسمية واضحة ووصفية.

• نصيحة احترافية للاختبار في Microsoft Teams: نظرًا للاختلافات الطفيفة في دعم Microsoft Teams للبطاقات التكيفية، نوصي باستخدام برنامج Windows Narrator المدمج أو NVDA للتحقق من ترتيب علامات التبويب والتأكد من أن الإعلانات تعمل كما هو متوقع.

خصائص المخطط المحددة

فيما يلي بعض الخصائص المحددة في مخطط بطاقات موائمة مفتوحة التي تعزز إمكانية الوصول.

خاصية "التسمية"

خاصية "التسمية" ضرورية لقارئات الشاشة. من خلال وجود اتصال بين التسميات والمدخلات، يمكن لمكتبات العرض ضبط الخصائص الضرورية لتمكين مستخدمي تقنيات المساعدة، مثل برامج قراءة الشاشة، من التفاعل بشكل صحيح مع المدخلات داخل بطاقات موائمة مفتوحة.

لمزيد من المعلومات، راجع Input.Text.

لماذا تُفضَّل "التسمية" على "النص الافتراضي" من حيث إمكانية الوصول؟

نوصي باستخدام خاصية "label" لوضع علامات على معلمات إدخال البطاقات الموائمة المفتوحة، بدلاً من خاصية "placeholder". إنها طريقة بسيطة وموجزة لتسمية المدخلات لمؤلفي البطاقات.

استخدام خصائص "TextBlock" كتسميات يمنعك من فرض القرب بين المدخلات والتسميات. باستخدام خاصية "label"، يمكنك التأكد من أن كلا العنصرين البصريين يتم عرضهما بجانب بعضهما البعض، مما يساعد المستخدمين الذين يحتاجون إلى مكبرات شاشة.

لمزيد من المعلومات، راجع التحقق من صحة المدخلات.

استخدام "errorMessage" لملاحظات الْتحقق مِنْ الْصحة

تتوفر خاصية "errorMessage" لجميع أنواع الإدخال لتحديد الرسالة التي ستظهر عندما يُدخل المستخدم قيمة غير صالحة.

لمزيد من المعلومات، راجع التحقق من صحة المدخلات.

TextBlock مع "style":‏ "heading" لهيكل إمكانية الوصول

باستخدام "style": يقوم "heading" بتطبيق نمط العنوان الافتراضي ويضع علامة على عنصر TextBlock كعنوان لأغراض إمكانية الوصول.

استعلم أكثر في TextBlock.

أزرار الإجراءات — "تعريف الأداة" للسرد

يدعم الإجراء "Action.ToggleVisibility" خاصية "tooltip" التي تحدد النص الذي يظهر عندما يحرك المستخدم مؤشر الماوس فوق الإجراء. يقرأ برنامج قراءة الشاشة هذا النص.

استعلم أكثر في Action.ToggleVisibility.

تنبيه بخصوص "isVisible": "false" لعناصر الإدخال

تأكد من أن عناصر الإدخال التي تتطلب التحقق تبقى مرئية. قد تؤدي عناصر الإدخال التي تحتوي على التحقق من الصحة ضمن "Action.ToggleVisibility" إلى حدوث ارتباك عندما تكون معلمات الإدخال المخفية غير صالحة.

استعلم أكثر في Action.ToggleVisibility.

خاصية "labelPosition" لـ Input.ChoiceSet

بالنسبة لـ "Input.ChoiceSet"، تحدد خاصية "labelPosition" موضع التسمية، إما في نفس السطر أو أعلاه (افتراضي).

استعلم أكثر في Input.ChoiceSet.