Back to guides

UserWay Widget: accessing content in iFrames

Any content inside an iFrame or in a shadow DOM is inaccessible to our widget.

iFrames and shadow DOM components are protected by the browser for security reasons. Unfortunately, this is the case for all the listed issues.

However, please keep in mind that this does not impact a native screen reader user’s experience. They have access to the accessibility tree provided by the operating system, while UserWay’s widget gets the accessibility details from the browser DOM.

The UserWay Widget is a JavaScript library. It runs in the JavaScript browser context and can interact with a page’s DOM structure only through mechanisms provided by the JavaScript engine.

The select element is notoriously difficult to control productively via JavaScript/CSS. This happens because the select element has complex inner structures with encapsulated logic/styling not exposed outside the element.

That’s why the target page JavaScript logic is not allowed to track:

  • Dropdown opened/closed
  • User alternates dropdown options

OS layer tech such as (NVDA, JAWS) are able to perform these functions. This is because they utilize Browser APIs that provide more extended information about selected/focused UI components.

Explore UserWay’s Accessibility Widget