# Slab 0.3.0

> Values screenreaders read the way you mean them, headings in Disclosure, dialogs in Popover, and the rest of the accessibility audit.

0.3.0 finishes the accessibility audit 0.2.0 began. Sliders, meters and ratings can say what their numbers mean, Disclosure and Popover take the roles they're used for, and Calendar, File Drop and Command Palette say what just happened. It's a minor release because Splitter's separator moved its focus, so check how you style it.

## TL;DR

- Slider, Range Slider, Meter, Progress and Rating take `formatValue`, so a screenreader reads "$40" or "3 of 5 GB" rather than a bare number.
- Disclosure's label can be a heading, and a Popover with a `label` is a dialog.
- Calendar ranges, File Drop and Command Palette tell screenreaders what just happened.
- Splitter's separator is a native range input inside, so phone screenreaders move it with a swipe.
- Splitter's focus ring moves to a `focus-visible` part.

## New features

- [Values that read right](../components/slider.md): `formatValue`, a function of the value whose result screenreaders read, such as "$40" or "3 stars", in Slider, Range Slider, Meter, Progress and Rating.
- [Disclosure headings](../components/disclosure.md): `heading-level` puts Disclosure's label in a heading of that level, as the APG's accordion does, so it's in a screenreader's list of headings.
- [Popover dialogs](../components/popover.md): With `label`, a Popover is a non-modal dialog named by it, for one that holds a form or controls rather than a few words.

## Fixes

### Screenreaders

- A range's first day, and then the whole range, are announced as they're picked. In Calendar.
- A drop says how many files were added, and how many were left out. In File Drop.
- How many results are left is announced once typing pauses, as in Combobox. In Command Palette.

### Touch and target size

- The separator is a native range input, so phone screenreaders move it with a swipe. In Splitter.
- The styled box is 24 pixels square, WCAG 2.5.8's smallest target. In Checkbox.

### Editors and docs

- The thumbs' parts are listed in the elements manifest again. In Range Slider, Color Picker.

## Before you upgrade

### Splitter's focus ring

The separator holds a hidden range input that takes focus, so it isn't `[role=separator]` and doesn't match `:focus-visible`. Style its ring through the `focus-visible` part.

Before:

```css
slab-splitter::part(separator):focus-visible {
  outline: 3px solid;
}
```

After:

```css
slab-splitter::part(separator focus-visible) {
  outline: 3px solid;
}
```

## Upgrade

```sh
pnpm add slab-elements@0.3.0
```
