# Badge

> Part of Tray UI 0.2.0, a design system in plain HTML and CSS (MIT licence). Every page: https://trayui.com/llms.txt

A badge states one fact about the thing beside it in a word or two. It is not a control.

## Two sizes
- `tray-badge` (32px, semibold): a status. Yellow means on, in season, act now; `track` grey means off.
- `tray-chip` (40px, medium): a plain fact set in a row with others: "30 g", "Chilled", "Pickup".

## Variants
| Class | Meaning |
| --- | --- |
| `tray-badge` | Neutral: the resting fill of the ground it sits on. |
| `tray-badge--accent` | On, new, in season. One per group. |
| `tray-badge--ink` | A count or a selected state. |
| `tray-badge--off` | Off, closed, out of season. |
| `tray-badge--danger`, `tray-badge--success` | A problem or a finished step: coloured text with an icon, never colour alone. |
| `tray-badge--count` | A 24px number on a tab or a menu item. |

A chip may carry a remove button (`tray-chip__x`, with an `aria-label`) when it shows an applied filter.

## Accessibility
A badge is plain text with no role: a screen reader reads its word where it stands, and `Tab` passes it by. The word carries the state, so the fill, or the `danger` and `success` colour, only repeats it, and the icon beside it is `aria-hidden`. A `tray-badge--count` is a bare number: say what it counts in the name of the tab or item it sits on, or in a `tray-vh` span inside it. A chip's `tray-chip__x` names the chip it removes, such as "Remove the filter Kyiv".

## Do and don't
- Do write the state as a word: "Paid", "Out of season".
- Do pair danger and success with an icon; the colour is not the message.
- Don't use a badge as a button. If it can be pressed it is a Toggle or a Button.
- Don't invent more colours; data colours stay inside charts.
