Skip to content

Motion and accessibility

Copy page

Dotquilt’s motion is slow and short by design, and every part of it can be stilled.

When a visitor asks their system for reduced motion, loaders show their still picture with no glow or breathing, and the handoff swaps at once. You don’t need to do anything.

Set motion="paused" on any element, and every loader inside it is still. To give visitors a pause control for the whole page, set it on <html>:

pauseButton.addEventListener('click', () => {
const paused = document.documentElement.getAttribute('motion') === 'paused';
document.documentElement.setAttribute('motion', paused ? 'system' : 'paused');
});

Automatic motion never runs longer than four seconds. A loader’s idle stops four seconds into a load and rests, so a long load never animates indefinitely. The handoff still plays when the content arrives, however long the load took: it lasts about a second. A handoff you ask for that is longer than four seconds is skipped.

  • Pending content is out of reach: while a region is pending, its content is inert and hidden from assistive technology.
  • Focus is kept: if focus is inside content that becomes pending, it moves to the region. When the content is ready, focus is not moved back; your page decides.
  • A focused handoff swaps at once, so nothing moves under the keyboard.
  • The marks are silent. Every loader is hidden from assistive technology with aria-hidden, and so is the placeholder layer.
  • Pending content is skipped. While a region is pending, its content is inert, hidden with aria-hidden, and marked aria-busy="true", so screen readers don’t read half-loaded content.
  • Refreshing content stays readable. While a region is refreshing, its content stays visible and usable, and is marked aria-busy="true" until it’s ready.
  • Ready content reads as usual. When the region is ready, aria-busy becomes false. Nothing is announced on its own: see below.

Loaders are decoration: they don’t announce anything. Label every region, so people know what is loading, and announce loading and errors in your own words, for example with a role="status" element outside the region.

In Windows high-contrast mode the marks are replaced by a dotted outline in the system text colour.