Доступность

SDK components

SDK реализует компоненты, подготовленные с HTML-атрибутами для обеспечения доступности — aria-label, tabindex, role и другими — которые позволяют осуществлять навигацию с клавиатуры между элементами, активируют звуковое сопровождение и используются программами чтения с экрана.

Best practices

При интеграции 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

Используйте этот атрибут с осторожностью — при неправильном применении или если он не удаляется по завершении потока захвата, он может нанести вред доступности элементов на странице.

References

• MDN — aria-hidden