---
title: "Accessibility"
description: "What the library does for you when users change their settings, and what's left to you."
canonical_url: "https://liquid-glass.bodbod.ir/docs/guide/accessibility"
---
# Accessibility

> What the library does for you when users change their settings, and what's left to you.

You don't have to configure any of this. It reacts to the user's settings as they change, without a reload.

<table>
<thead>
  <tr>
    <th>
      User setting
    </th>
    
    <th>
      What happens
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        prefers-reduced-motion: reduce
      </code>
    </td>
    
    <td>
      The glass stays, but refraction drops to 35% of its value, zoom drops to 1 and the pointer highlight is off. There is no animation loop in any case.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reducedMotion="fallback"
      </code>
      
       and reduce
    </td>
    
    <td>
      The CSS fallback is used instead of the shader.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reducedMotion="static"
      </code>
    </td>
    
    <td>
      Always behaves as if reduce were set.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reducedMotion="ignore"
      </code>
    </td>
    
    <td>
      Ignores the setting. Not recommended.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        prefers-reduced-transparency: reduce
      </code>
    </td>
    
    <td>
      A solid surface, never glass.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        prefers-contrast: more
      </code>
      
      , <code>
        forced-colors: active
      </code>
    </td>
    
    <td>
      A solid <code>
        Canvas
      </code>
      
       / <code>
        CanvasText
      </code>
      
       surface with a visible border, never glass.
    </td>
  </tr>
  
  <tr>
    <td>
      Save-Data
    </td>
    
    <td>
      <code>
        auto
      </code>
      
       quality starts at <code>
        low
      </code>
      
      , and snapshots are skipped unless you set <code>
        ignoreSaveData
      </code>
      
      .
    </td>
  </tr>
</tbody>
</table>

## Screen readers and keyboards

The canvas is purely decorative. It has `aria-hidden="true"` and `pointer-events: none`, and it can't take focus. Whatever you put inside the lens is ordinary DOM, so it can be selected and focused, and screen readers read it as normal.

## Legibility is your responsibility

Glass over an arbitrary backdrop can't promise enough contrast, because the library doesn't know what will end up behind your text. If the lens holds body text, make the tint opaque enough that the text meets WCAG AA (4.5:1) against the worst case behind it. White text on `tint="rgb(15 23 42 / 0.55)"` is a reasonable start, and so is dark text on `tint="rgb(255 255 255 / 0.7)"`. Then check it with a contrast tool against your real backdrop.


## Sitemap

See the full [sitemap](https://liquid-glass.bodbod.ir/sitemap.md) for all pages.
