Skip to content

videos do not provide text transcripts #2828

@Ovgodd

Description

@Ovgodd

What’s broken?

This issue was identified during the Docs accessibility audit on a page containing table-related content.

Audited page:
https://docs.numerique.gouv.fr/docs/0d998bef-1b69-47ce-bd18-83d4d849c734/

For example, the video “Ajouter des colonnes et des lignes” shows how to add rows and columns using the mouse, but there is no text transcript explaining the same action for blind or visually impaired users.

The videos are also preceded by a title, but there is no additional context explaining the goal of the video before the user watches it.

Because of this, users who cannot see the video may not understand the demonstrated table interaction.

WCAG Criteria

WCAG 1.2.1 - Audio-only and Video-only (Prerecorded)

BlockNote version

0.51.4

What did you expect to happen?

Each video that demonstrates an interaction should provide a text transcript.

The transcript should describe the action shown in the video.

When the mouse workflow and keyboard workflow are different, the transcript should explain both.

Example:

  • how to add a row using the mouse;
  • how to add a row using the keyboard;
  • how to add a column using the mouse;
  • how to add a column using the keyboard.

Steps to reproduce

Steps to reproduce

  1. Open the audited Docs document.
  2. Go to a table-related video, for example “Ajouter des colonnes et des lignes”.
  3. Notice that the video demonstrates the action visually.
  4. Notice that no text transcript is provided for users who cannot access the visual content.

Impact

Blind and visually impaired users may not be able to understand the interaction demonstrated in the video.

Keyboard-only users may also miss important information when the keyboard workflow differs from the mouse workflow.

BlockNote version

0.51.4

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-triageIssue has not yet been reviewed or classified by maintainers.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions