Contrib.social

Provide "decorative" option in formatter settings to ignore from screen readers

Open on Drupal.org →
Created on 21 August 2025, 3 days ago

Problem/Motivation

If you include a video asset using EMBED CODE formatter as a background / decorative element it will trigger warnings in WCAG and ADA checks due to missing information, i.e.:

Failed Checks:

  • Video element visual-only content has accessible alternative.
  • Video element auditory content has accessible alternative
  • Video element visual content has accessible alternative

Steps to reproduce

  • Add a video in the DAM.
  • Add content type with a media field that allows Acquia DAM: Video
  • Configure Acquia DAM: Video formatter to Browser HTML5 player with loop, autoplay, muted
  • Create a new page, select the video, publish page
  • Run accessibility scans on page

    • Proposed resolution

    Provide a "decorative" option in the embed code formatter settings which, when toggled on, will add aria-hidden="true" to the embed.

    Remaining tasks

    1. Add decorative option to embed code formatter settings
    2. Adjust EmbedCodeFormatter to add the aria-hidden="true" attribute when the setting is TRUE/1

    User interface changes

    New toggle on the field display settings for embed code formatter

    API changes

    Data model changes

    ✨ Feature request
    Status

    Active

    Version

    1.1

    Component

    Code

    Created by

    🇺🇸United States dan612 Portland, Maine

    Live updates comments and jobs are added and updated live.
    Sign in to follow issues

    Merge Requests

    Comments & Activities

    contrib.social Blog FAQ Discussions
    Production build 0.71.5 2024