M ChartM Chart
Users
Pro
Developers
Download
GitHub
Users
Pro
Developers
Download
GitHub
  • User Guide

    • User Guide
    • Libraries
    • Types of Charts
    • Creating a Chart
    • Multiple Sheets
    • Scatter & Bubble Charts
    • Radar & Radar Area Charts
    • Treemap Charts
    • Boxplots & Violin Charts
    • Venn & Euler Charts
    • Chart Shortcode
    • Block Editor
    • CSV Import & Export
    • Settings
    • Chart Units
    • Themes
    • Accessibility
    • Duplicating Charts
    • Example Charts

Accessibility

M Chart aims to make rendered charts usable with assistive technology out of the box. No configuration is required. The features below apply automatically to charts you embed via shortcode or the block editor.

Accessible data table fallback

Every interactive Chart.js chart is rendered alongside a hidden HTML data table that screen readers can navigate. The table is a real <table> with:

  • A <caption> carrying the chart title (and sheet name on multi-sheet charts)
  • A <thead> for the header row
  • scope attributes on header cells so rows and columns are announced correctly

This gives screen-reader users the underlying numbers in a structured form, even though the chart itself is drawn on a <canvas>.

Charts displayed as tables

On a chart using M Chart Pro's Display as Table, the table is the visible content. It has a <caption>, scope="col" on the column headers, and scope="row" on row headers when the first column is a header. There is no <canvas>, so the hidden fallback table and the ARIA associations below don't apply.

Screen-reader summary and description

Each chart's <canvas> carries three ARIA associations, all pointing at visually hidden (screen-reader-text) elements:

  • aria-labelledby → a <figcaption> holding the chart title, which serves as the chart's accessible name.
  • aria-describedby → a short summary paragraph (see below).
  • aria-details → the container holding the full data table described above, so assistive technology can navigate the underlying numbers as a real table rather than hearing them read as one long description.

The chart summary

The summary paragraph announced with the chart is:

  • The chart's excerpt, if you've written one — this is the place to put a human-written, one-or-two-sentence takeaway of what the chart shows.
  • Otherwise, an auto-generated summary built from the chart type, subtitle, source attribution, and the dimensions of the data — for example: "Line chart. Source: World Bank. Data table with 12 rows and 3 columns follows."

When a chart has source attribution enabled, the source also appears in its own screen-reader-only paragraph alongside the visible attribution painted on the chart.

Developers can add more text, such as methodology, a trend summary, or an extended description, after the data table. See the m_chart_screen_reader_text hook in the developer docs.

Live region on the block picker

In the block editor, the M Chart block's chart-count message is an ARIA live region (role="status"), so screen readers announce the number of matching charts as you search.

Language attributes on embeds

Charts embedded via iframe output the site's language attributes on the embed document, so screen readers and browsers correctly identify the content language.

Last Updated: 11/7/26, 6:48 PM
Contributors: Jamie Poitra
Prev
Themes
Next
Duplicating Charts