لقطة ARIA للمساعد قد تعرض أسماء أزرار وعناوين وحالات في نص منظم، فتساعد على قراءة بنية واجهة. لكنها ليست صورة الصفحة. إذا سألنا عن لون زر أو موضعه، لا نخترع بكسلات من اسم العنصر. نقرأ توثيق Playwright ونكتب تمثيلا مؤلفا للمقارنة، دون زيارة واجهة أو تشغيل اختبار.
الخلاصة السريعة
لا؛ هي تمثيل YAML لشجرة إمكانية الوصول. ما يصرح بالدور والاسم والحالة لا يصرح تلقائيا باللون أو بإحداثيات الشاشة أو بنتيجة فعل.
- يوثق Playwright لقطة ARIA بوصفها YAML لشجرة إمكانية الوصول، تضم أدوار العناصر وأسماءها وسماتها ومحتواها النصي. [1] نميز هذه المادة من صورة البكسلات.
- في تمثيلنا المؤلف يظهر عنوان «بطاقات» وزر «حفظ» مع disabled؛ نستطيع قراءة الدور والاسم والحالة المكتوبة، لكن لا نحدد لون الزر أو موضعه من هذا النص.
- يمكن للمطابقة الجزئية الموثقة حذف الاسم أو سمات الحالة من الشرط. [1] شرط button وحده في تمريننا لا يفحص كلمة «حفظ» أو disabled؛ لا نعده مطابقة كاملة.
- اختر المادة المناسبة للسؤال ونطاقها؛ وصف بنية العنصر لا يثبت اكتمال حفظ أو توفر فعل الآن. لا نستنتج غياب عنصر عن الموقع كله من جزء محدود لم يشمله.
ما الذي تمثله اللقطة النصية؟
يعرض Playwright لقطة ARIA في YAML لشجرة إمكانية الوصول، مع أدوار وأسماء وسمات وقيم ومحتوى نصي في بنية هرمية. [1]
تعني البنية الهرمية أن وضع عنصر داخل مجموعة يصف علاقة في هذا التمثيل. لا نساوي الإزاحة في سطر النص بمسافة أفقية مقاسة على شاشة، ولا نستخرج لونا من اسم الدور.
يمكن تقديم هذه المادة إلى مساعد لشرح ما ورد فيها، بشرط حفظ نوعها وحدودها. تسميتها «لقطة» لا تجعلها ملف صورة، كما أن قراءة نصها لا تعني أننا فتحنا الصفحة التي تخصها.
ثلاث معلومات صريحة ومعلومتان غائبتان
نؤلف تمثيلا فيه heading باسم «بطاقات» ومستوى 1، ثم button باسم «حفظ» مع disabled. هذه عناصر تعليمية معلنة، وليست لقطة جمعت من موقع فعلي.
السؤال «ما اسم الزر وحالته المكتوبة؟» يجيب عنه النص: حفظ، ومعه disabled. أما «هل الزر أزرق وفي يمين الشاشة؟» فلا نجد له لونا أو إحداثيات في المادة المقدمة. لا تتحول عادة تصميم مألوفة إلى دليل على هذين الوصفين.
كذلك لا يثبت الاسم أن حفظا وقع. اسم العنصر يصف ما قدم في التمثيل، لا ملفا محفوظا في النظام. وإذا احتجنا وصف الألوان في واجهة فعلية، نقترح صورة مناسبة لنفس الحالة؛ لم نحصل على هذه الصورة في التمرين.
هل شرط جزئي يفحص كل الوصف؟
يسمح التوثيق بمطابقة جزئية تحذف الاسم أو بعض السمات، مثل checked أو disabled، من قالب المقارنة. [1]
نفرض شرطا مكتوبا يطلب button فقط. هذا الشرط لا يسأل في مثالنا هل اسم الزر «حفظ»، ولا هل يحمل disabled. لذلك لا نصفه بأنه تحقق من هاتين المعلومتين، حتى إن ظهر الزر المطلوب في المادة.
إذا كان غرض المراجعة الاسم والحالة معا، نكتبهما ضمن الشروط المقصودة ونراجع التمثيل بهما. أما نتائج اختبار برمجي فموضوع آخر؛ لا نزعم نجاح assertion أو توفر تفاعل من هذا التمرين الورقي.
كيف نطلب جوابا يطابق المادة؟
قل للمساعد ما نوع المادة، وما النطاق الذي تغطيه، وما الوصف الذي تريد فحصه. لقراءة اسم وحالة مكتوبين نعود إلى النص؛ وللمظهر نحتاج مادة بصرية مناسبة للحالة نفسها، ولا ننقل دليل إحداهما إلى الأخرى.
وإذا كانت اللقطة لمجموعة محدودة فلا نستنتج أن الموقع كله يخلو من خيار غائب عنها. لا نخلط كذلك وجود اسم أو سمة مع نجاح إجراء أو الحالة الحالية بعد وقت لاحق.
تظل المراجعة مفيدة حين تصرح بما يجيب عنه التمثيل وما يحتاج مادة إضافية. لم ننفذ نقرًا أو اختبار إمكانية وصول أو فحص بكسلات؛ شرحنا حدود سؤال على بنية نصية مؤلفة.
المصادر ومتابعة القراءة
- Playwright: Aria snapshots (يفتح في نافذة جديدة)playwright.dev
أُعدّ هذا المقال بصياغة عربية أصلية بالاستناد إلى المصادر أعلاه، وهو مدخل تمهيدي إلى الموضوع. اقرأ منهجية المحتوى وحدوده.