# Element tag

> A breakdown element as a small tab in its department's pencil colour, with an optional quantity.

Source: https://kwark.space/designSystem/components/element-tag

## Usage

### When to use
On breakdown sheets, the elements list, shot cards that need an element, and the call sheet's notes per department.

### When not to
- For filters or toggles. Use a [Chip](https://kwark.space/designSystem/components/chip.md).
- For status. Use a [Badge](https://kwark.space/designSystem/components/badge.md).

### Anatomy in use
22px tall, 4px corners, a 22% wash of the pencil and a 3px pencil edge on the left. The quantity sits after the name in mono, the way a sheet writes "x12".

### Colours
Pencil colours follow the logic of the standard pencil box: nothing that reads as cast red or effect blue for another department, so a marked page still says what is what (breakdown.css). Departments keep their colour across the whole app.

### Writing
The element in the script's words ("Reel 3"), not a catalogue name.

**Do:** *Lab techs ×4* in the background colour.

**Don't:** Four separate tags reading *Lab tech*.

## Style

### Anatomy

`.kw-element-tag` with `data-category`; `.kw-element-tag__qty` for counts. Use `<button>` when it opens the element.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-bk-cast` | #e0685c |  |
| `--k-bk-prop` | #a98bd6 |  |
| `--k-bk-wardrobe` | #72b07e |  |
| `--k-bk-vehicle` | #e38fb4 |  |
| `--k-bk-background` | #d9c36a |  |
| `--k-bk-sfx` | #6fa3d8 |  |
| `--k-bk-stunt` | #e59a4a |  |

## Code

### React

In the Kwark app: `// .bk-chip in pages/PreProduction/BreakdownModule (ProductionOffice.css)`.

```tsx
<span className="bk-chip" data-category="prop">Reel 3</span>
```

| Prop | Type | Notes |
|---|---|---|
| `data-category` | `string` | a standard or project category id |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<span class="kw-element-tag" data-category="cast">Mira</span>
<span class="kw-element-tag" data-category="prop">Reel 3</span>
<span class="kw-element-tag" data-category="wardrobe">Mira’s cardigan</span>
<span class="kw-element-tag" data-category="vehicle">Courier scooter</span>
<span class="kw-element-tag" data-category="background">Lab techs <span class="kw-element-tag__qty">×4</span></span>
<span class="kw-element-tag" data-category="sfx">Rain</span>
<span class="kw-element-tag" data-category="stunt">Rooftop fall</span>
```

## Accessibility

- The tag text is the element; the category must be available too: put it in a visually hidden prefix or the group heading ("Props").
- Never rely on the pencil colour alone.

## For agents

### Rules

- **Must** keep each department's pencil colour the same everywhere in the app.
- **Must** say the category in words near every tag.
- **Never** use element tags as filters.

### AI readiness test

**Task:** List the elements for Scene 12 on the call sheet.

**Give the agent:** Element tag, Call sheet, Breakdown page.

**Constraint:** The call sheet prints in black ink.

**A reliable answer:**
- Grouped by department heading
- Tags with quantities
- Print falls back to department words, not colour
- Names in the script's words
