עצות בנושא נגישות עבור כרטיסים מסתגלים

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" לקבלת הוראות: אם מקטע של שדות אופציונליים זקוק להקשר, הגדר את "type" כ- "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 ב- Windows או ב- NVDA כדי לאמת את סדר הטאבים, והכרזות פועלות כצפוי.

מאפייני סכימה ספציפיים

להלן כמה מאפיינים ספציפיים בסכימה כרטיסים מסתגלים לעזור בשיפור הנגישות.

המאפיין "label"

המאפיין "תווית" הוא קריטי עבור קוראי מסך. על-ידי חיבור בין תוויות לקלט, ספריות מעבד יכולות להגדיר את המאפיינים הדרושים כדי לאפשר למשתמשים של טכנולוגיות מסייעות, כגון קוראי מסך, לקיים אינטראקציה נכונה עם קלט בתוך כרטיסים מסתגלים.

קבל מידע נוסף ב- Input.Text.

מדוע "label" עדיף על "placeholder" לנגישות?

אנו ממליצים להשתמש במאפיין "label" לתיוג כרטיסים מסתגלים קלט, במקום במאפיין "placeholder". זו דרך פשוטה ותמציתית לתיוג קלט עבור מחברי כרטיס.

שימוש במאפיינים "TextBlock" כתוויות מונע ממך לאכוף קירבה בין קלט ותוויות. על-ידי שימוש במאפיין "תווית", באפשרותך להבטיח כי שני הרכיבים החזותיים יעובדו זה לצד זה, דבר אשר עוזר למשתמשים זקוקים לזכוכית מגדלת של מסך.

קבל מידע נוסף באימות קלט.

השתמש ב"errorMessage" עבור משוב אימות

המאפיין "errorMessage" זמין עבור כל סוגי הקלט כדי לציין את ההודעה שתציג כאשר משתמש מזין ערך שאינו חוקי.

קבל מידע נוסף באימות קלט.

TextBlock עם "סגנון": "כותרת" למבנה נגישות

שימוש ב- "style": "heading" מחיל את סגנון הכותרת המוגדר כברירת מחדל ומסמן את הרכיב TextBlock ככותרת לנגישות.

קבל מידע נוסף ב-TextBlock.

לחצני פעולה – 'תיאור כלי' עבור מלל נלווה

הפעולה "Action.ToggleVisibility" תומכת במאפיין "תיאור כלי" המגדיר טקסט שמופיע כאשר המשתמש מרחף עם העכבר מעל הפעולה. תוכנת הקראה קוראת את הטקסט הזה.

קבל מידע נוסף ב - Action.ToggleVisibility.

זהירות עם "isVisible": "false" עבור רכיבי קלט

השאר רכיבי קלט עם אימות גלוי. רכיבי קלט עם אימות תחת "Action.ToggleVisibility" עלולים לגרום לבלבול כאשר פרמטרי קלט מוסתרים אינם חוקיים.

קבל מידע נוסף ב - Action.ToggleVisibility.

המאפיין "labelPosition" עבור Input.ChoiceSet

עבור Input.ChoiceSet, המאפיין "labelPosition" קובע את מיקום התווית, בתוך השורה או מעל (ברירת מחדל).

קבל מידע נוסף ב- Input.ChoiceSet.