# Filter Transitions
> A filterable grid: the ink pill slides to the filter, leaving cards step back, the others glide to their new place and the new ones arrive in turn.
Data display · filter, grid, flip, pills · HTML, CSS, vanilla JS · no dependencies · updated 2026-10-16
Demo: https://kodza.dev/components/filter-transitions/
## Files
The code below, served as files: byte for byte what the Kodza site copies (the CSS includes its theme guard).
- [`kodza-filter-transitions.css`](https://kodza.dev/registry/filter-transitions/kodza-filter-transitions.css) · 11.8 KB
- [`kodza-filter-transitions.js`](https://kodza.dev/registry/filter-transitions/kodza-filter-transitions.js) · 8.0 KB
- [`kodza-filter-transitions.html`](https://kodza.dev/registry/filter-transitions/kodza-filter-transitions.html) · 3.7 KB · the markup, to adapt and paste into your page
**Can you run shell commands? Download the CSS and the JS, don't retype them.** Retyping costs thousands of tokens and can drop or change lines of the CSS. Put the files where your stack expects them (Use it says where: change the `-o` paths):
```bash
curl -fsSL --create-dirs -o kodza/kodza-filter-transitions.css https://kodza.dev/registry/filter-transitions/kodza-filter-transitions.css
curl -fsSL --create-dirs -o kodza/kodza-filter-transitions.js https://kodza.dev/registry/filter-transitions/kodza-filter-transitions.js
```
Then load the files from your page as Use it shows, instead of pasting the content. The HTML is the part you adapt (text, links, modifiers): paste it from the Code section. Copy the CSS and the JS from the Code section only if you can't run commands, exactly as they are. (Windows PowerShell: `curl.exe`.)
## API
- Root: `.kodza-filter`
- Variables (set them on the root element itself: it declares its own defaults):
- `--kz-filter-bg: #ffffff`
- `--kz-filter-fg: #0a0a0a`
- `--kz-filter-muted: rgba(10, 10, 10, 0.62)`
- `--kz-filter-line: rgba(10, 10, 10, 0.1)`
- `--kz-filter-ink: #0a0a0a`
- `--kz-filter-on-ink: #ffffff`
- `--kz-filter-columns: 4`
- `--kz-filter-gap: 16px`
- `--kz-filter-radius: 16px`
- `--kz-filter-ease: cubic-bezier(0.22, 1, 0.36, 1)`
- Attributes:
- `data-category` (e.g. `buttons`, `text`, `images`, `cards`)
- `data-filter` (e.g. `all`, `buttons`, `text`, `images`, `cards`)
- Events: `kodza:filter` (bubbling, from the root)
- Lifecycle: `kodza:init` / `kodza:destroy` on `document`, with `{ detail: { root } }` to target a container.
## Dark mode
The values Kodza uses on a dark background (`#0a0a0a`). For a page that follows the system theme, add them after the component's CSS:
```css
@media (prefers-color-scheme: dark) {
.kodza-filter {
--kz-filter-bg: #161616;
--kz-filter-fg: #f2f2f0;
--kz-filter-muted: rgba(242, 242, 240, 0.62);
--kz-filter-line: rgba(255, 255, 255, 0.12);
--kz-filter-ink: #f2f2f0;
--kz-filter-on-ink: #0a0a0a;
}
}
```
A site with its own theme switch puts the same rules under its dark selector instead (`[data-theme="dark"] .kodza-filter { … }`); a single dark section, under that section's class.
Its images have dark versions next to them (`kz-block-1400.webp` → `kz-block-dark-1400.webp`). To swap them on a dark page: ``.
## Use it
### Plain HTML page
- CSS: `kodza/kodza-filter-transitions.css` next to the page (the Files commands as they are), linked in ``: ``. Without a shell, paste it in a `
