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?