الانتقال إلى المحتوى الرئيسي

إمكانية الوصول

مكونات SDK

يُطبّق SDK مكونات مُجهَّزة بسمات HTML لإمكانية الوصول — aria-label وtabindex وrole وغيرها — مما يُتيح التنقل بلوحة المفاتيح بين العناصر، وتفعيل التوجيه الصوتي، كما تستخدمها برامج قراءة الشاشة.

أفضل الممارسات

عند دمج Web SDK في صفحة ما، قد تكون هناك عناصر تفاعلية أخرى غير مرئية خلال تدفق فتح الكاميرا والتقاط الصورة. قد تتعارض هذه العناصر مع المعلومات الواردة في تدفق الالتقاط، مما يُخلّ بتجربة المستخدم. لذلك، من المهم إزالة التفاعل مع العناصر الأخرى أو تعطيله خلال فترة الالتقاط.

يمكن تحقيق ذلك بعدة طرق، تبعاً للعناصر والأطر الموجودة على الصفحة. فيما يلي مثال باستخدام سمة aria-hidden:

// page html
// <div id="main-content">
//   <header>...</header>
//   <button id="my-button">Interactive Button</button>
//   <footer>...</footer>
// </div>

const unicoSdk = new UnicoCheckBuilder().build();

unicoSdk
  .prepareSelfieCamera(/* ... */)
  .then((cameraOpener) => {
    const pageElement = document.getElementById('main-content');
    pageElement.setAttribute('aria-hidden', true);

    cameraOpener.open({
      on: {
        success: (obj) => {
          pageElement.setAttribute('aria-hidden', false);
        },
        error: (error) => {
          pageElement.setAttribute('aria-hidden', false);
        },
      },
    });
  });
تنبيه بشأن aria-hidden

استخدم هذه السمة بحذر — فقد تُضرّ بإمكانية الوصول إلى العناصر الموجودة على الصفحة إذا طُبِّقت بشكل غير صحيح أو لم تُزَل عند انتهاء تدفق الالتقاط.

المراجع
آخر تحديث في