נגישות ויכולת בדיקה

בארכיטקטורה מהיום הראשון

תוכן של canvas אינו נראה לקוראי מסך מעצם טבעו. doper אינו מתייחס לנגישות כשכבה שמולבשת אחרי ההשקה: הליבה מתחזקת עץ סמנטי (role / label / value / bounds / focusable), ו-@dopejs/pingo-a11y ממפה אותו באופן מצטבר לעץ DOM צללי ממוקם אבסולוטית לצד ה-canvas.

רכיבי הצל שקופים חזותית אך קיימים בעץ הנגישות ובסדר המעבר ב-Tab; מיקוד בהם מועבר להפעלת העריכה של המנוע, כך שמשתמשי מקלדת יכולים באמת להפעיל את שדות הקלט שבתוך ה-canvas.

הצהרת סמנטיקה

<container semanticRole="region" semanticLabel="לוח תשלום">
  <text value="תשלום" semanticRole="heading" semanticLabel="תשלום" />
  {TextField({ semanticLabel: "נמען", value, revision })}
</container>

ל-editableText יש סמנטיקת textbox כברירת מחדל. ערך של שדה סיסמה לעולם אינו נכנס לעץ הסמנטי.

בדיקות E2E מבוססות סמנטיקה

מכיוון שהעץ הסמנטי משתקף ל-DOM אמיתי, בדיקות E2E יכולות לבחור לפי תפקיד ושם במקום להשוות פיקסלים:

import { getByRole, queryAllByRole } from "@dopejs/pingo";

const email = getByRole(document.body, "textbox", { name: "נמען" });
email.focus(); // מועבר להפעלת העריכה של המנוע
expect(queryAllByRole(document.body, "textbox")).toHaveLength(2);

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

מעקב אחר העץ הסמנטי

const root = await createHostedCanvasRoot(canvas, {
  onSemantics: (nodes) => inspect(nodes),
  accessibility: true, // פעיל כברירת מחדל; false מכבה את עץ הצל
});

כל צומת מספק nodeId, role, label, value, bounds בקואורדינטות עולם, focusable, focused והדגל password. באבחון הפריים, dirtySemanticsNodes מאפשר לעקוב אחר תדירות ההשבתה הסמנטית.

הסמכת פלטפורמה

האוטומציה מכסה את ייצוא העץ הסמנטי, את המיפוי לעץ הצל, את הבוררים לפי תפקיד ותווית ואת חוזה המקלדת. מטריצת ההתנהגות של קוראי מסך אמיתיים (VoiceOver, NVDA, TalkBack) שייכת להסמכת פלטפורמה, נמדדת בנפרד ואינה נחשבת תנאי לסיום העבודה ההנדסית. הקו הזה מונע הצגת מסקנות לא מאומתות על מכשירים כהבטחת תמיכה.

בהדגמת הסמנטיקה ב-Playground אפשר לקרוא ישירות את העץ הסמנטי הנוכחי.