Skip to main content

How to Use Ignore Attributes to Exclude Elements from UserWay Widget Features

The UserWay Widget provides a variety of accessibility enhancements, such as contrast adjustments, text spacing, line height modifications, link highlighting, live translation, and more.
​

In some cases, you may want to prevent a specific element from being affected by one or more of these features. To do so, you can add a dedicated HTML attribute directly to the element you want to exclude.
​

Important

These attributes must be applied directly to the target element. They will not work when added to parent containers.
​

Correct Usage

<p data-uw-ignore-s17>Some text</p>

The paragraph above will be ignored by the Line Height feature.
​

Incorrect Usage

<div data-uw-ignore-s17>     <p>Some text</p> </div>

The paragraph above will still be affected because the attribute is applied to the parent <div> rather than the target element itself.


Available Ignore Attributes

Feature

Attribute

Notes

Contrast

data-uw-ignore-s3

Excludes the element from contrast adjustments.

Highlight Links

data-uw-ignore-s6

Prevents the link from being highlighted.

Tooltips

data-uw-ignore-s12

Excludes the element from tooltip enhancements.

Text Spacing

data-uw-ignore-s14

Prevents text spacing modifications.

Text Align

data-uw-s19-ignore

Prevents text alignment changes.

Line Height

data-uw-ignore-s17

Prevents line height adjustments.

Hide Images

data-uw-ignore-s25

Prevents images from being hidden.

Live Translation

data-uw-ignore-translate="true"

Must include ="true".

Headings Remediation

data-uw-ignore-rm-heading

Prevents heading remediation.

Image Alt Remediation

data-uw-rm-ignore="true"

Must include ="true".


Examples

Contrast

<p data-uw-ignore-s3>     This content will not receive contrast adjustments. </p>

Highlight Links

<a href="#" data-uw-ignore-s6>     This link will not be highlighted. </a>

Tooltips

<span data-uw-ignore-s12>     This element will not receive tooltips. </span>

Text Spacing

<p data-uw-ignore-s14>     This paragraph will not receive text spacing modifications. </p>

Text Align

<p data-uw-s19-ignore>     This paragraph will not receive text alignment changes. </p>

Line Height

<p data-uw-ignore-s17>     This paragraph will not receive line height adjustments. </p>

Hide Images

<img src="example.jpg"      alt="Example image"      data-uw-ignore-s25 />

This image will not be affected by the Hide Images feature.

Live Translation

<p data-uw-ignore-translate="true">     This text will not be translated. </p>

Headings Remediation

<h3 data-uw-ignore-rm-heading>     This heading will not be remediated. </h3>

Image Alt Remediation

<img src="example.jpg"      alt=""      data-uw-rm-ignore="true" />

This image will be excluded from UserWay's Image Alt remediation process.


Additional Notes

  • Multiple ignore attributes can be applied to the same element when necessary.

  • These attributes only affect the specific feature associated with the attribute.

  • Applying an ignore attribute to a parent container will not exclude its child elements.

  • For Live Translation and Image Alt Remediation, the attribute must include ="true" exactly as shown in the examples.

Did this answer your question?