Skip to content

3lvia/designsystem / skills/elvia-design-system

elvia-design-system

Verified

Reference for UI components and patterns in Elvia's design system ("Elvis"). Covers component- and pattern-specific guidelines for sizing, color tokens for custom UI, types, ordering, labeling, accessibility attributes, CSS setup, and web-component registration. Use when building, reviewing, or fixing UI in an Elvia frontend, even if the request doesn't name Elvia or the CSS classes explicitly (e.g. "add a save button", "make this icon bigger", "add a tooltip").

FileKindSize
README.mdmarkdown726 B
SKILL.mdskill md10.4 KB
references/accordion.mdmarkdown5.9 KB
references/alert.mdmarkdown4.3 KB
references/app-bridge.mdmarkdown3.3 KB
references/autocomplete.mdmarkdown5.5 KB
references/badge.mdmarkdown2.3 KB
references/box.mdmarkdown2.0 KB
references/breadcrumb.mdmarkdown2.9 KB
references/button.mdmarkdown6.0 KB
references/card.mdmarkdown5.6 KB
references/carousel.mdmarkdown4.4 KB
references/checkbox.mdmarkdown4.7 KB
references/chip.mdmarkdown4.1 KB
references/color-tokens.mdmarkdown5.6 KB
references/content-loader.mdmarkdown2.0 KB
references/context-menu.mdmarkdown6.6 KB
references/data-formats.mdmarkdown2.1 KB
references/datepicker-range.mdmarkdown5.4 KB
references/datepicker.mdmarkdown6.0 KB
references/divider.mdmarkdown2.4 KB
references/drag-and-drop.mdmarkdown2.0 KB
references/dropdown.mdmarkdown6.7 KB
references/empty-state.mdmarkdown3.0 KB
references/file-upload.mdmarkdown2.6 KB
references/form-field.mdmarkdown2.7 KB
references/header.mdmarkdown5.8 KB
references/icon.mdmarkdown5.0 KB
references/illustrations.mdmarkdown1.4 KB
references/input.mdmarkdown2.5 KB
references/installation.mdmarkdown2.1 KB
references/link.mdmarkdown3.3 KB
references/list.mdmarkdown2.0 KB
references/modal.mdmarkdown6.1 KB
references/pagination.mdmarkdown4.0 KB
references/popover.mdmarkdown5.3 KB
references/progress-linear.mdmarkdown3.1 KB
references/radio-button.mdmarkdown2.6 KB
references/radio-filter.mdmarkdown2.8 KB
references/search-pattern.mdmarkdown2.7 KB
references/segmented-control.mdmarkdown3.9 KB
references/shadows.mdmarkdown1.3 KB
references/slider.mdmarkdown3.6 KB
references/stepper.mdmarkdown4.7 KB
references/table.mdmarkdown8.4 KB
references/tabs.mdmarkdown3.8 KB
references/tag.mdmarkdown5.0 KB
references/thumbnail.mdmarkdown1.9 KB
references/timepicker.mdmarkdown5.1 KB
references/toast.mdmarkdown3.4 KB
references/toggle.mdmarkdown2.1 KB
references/tooltip.mdmarkdown4.1 KB
references/typography.mdmarkdown3.3 KB
references/utility-classes.mdmarkdown3.9 KB
references/web-components.mdmarkdown2.1 KB

references/checkbox.md

View on GitHub
- [Checkbox (`e-checkbox`)](#checkbox-e-checkbox)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Props](#props)
    - [Size](#size)
    - [State](#state)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [Nested checkboxes](#nested-checkboxes)
  - [Accessibility](#accessibility)
  - [Classes](#classes)
  - [Examples](#examples)

# Checkbox (`e-checkbox`)

## Reference

https://design.elvia.io/components/checkbox

CSS-only component for a native checkbox input and its label.

## Installation

This CSS-based component requires the `@elvia/elvis` package. If it is not already installed, follow the
[Elvis installation reference](./installation.md) before using the checkbox classes.

## Use

```html
<label class="e-checkbox">
  <input type="checkbox" name="notifications" />
  <span class="e-checkbox__mark"></span>
  <span class="e-checkbox__label">Send me notifications</span>
</label>
```

## Props

### Size

- **Medium** `e-checkbox`
- **Small** `e-checkbox--small`

### State

Use native input attributes for semantic state. These classes represent state when application logic controls
the styling.

- **Checked**: set `checked` on the input, or use `e-checkbox---checked`.
- **Focus**: `e-checkbox---focus`.
- **Hover**: `e-checkbox---hover`.
- **Disabled**: set `disabled` on the input, or use `e-checkbox---disabled`.
- **Disabled checked**: set both `checked` and `disabled`, or use `e-checkbox---disabled-checked`.
- **Invalid**: use the input's native validity state with `e-checkbox---invalid`.
- **Indeterminate**: use `e-checkbox--indeterminate` when a parent represents a nested group with only some
  children selected.
- **Inverted**: use `e-checkbox--inverted` on an inverted background.

## Guidelines

### When to use

Use checkboxes for independent toggles or multiple selections. Use radio buttons when exactly one option can
be selected.

### Nested checkboxes

Use `e-checkbox--indeterminate` on a parent when a nested group is partially selected. Apply it from
application logic as child selections change; it is visual styling, not the native input state.

Wrap the group in `e-form-field`. Wrap its child checkboxes in `e-form-field__nested`.

```html
<div class="e-form-field">
  <label class="e-checkbox e-checkbox--indeterminate">
    <input type="checkbox" aria-controls="notification-options" />
    <span class="e-checkbox__mark"></span>
    <span class="e-checkbox__label">All notifications</span>
  </label>
  <div id="notification-options" class="e-form-field__nested">
    <label class="e-checkbox">
      <input type="checkbox" checked />
      <span class="e-checkbox__mark"></span>
      <span class="e-checkbox__label">Email</span>
    </label>
    <label class="e-checkbox">
      <input type="checkbox" />
      <span class="e-checkbox__mark"></span>
      <span class="e-checkbox__label">SMS</span>
    </label>
  </div>
</div>
```

## Accessibility

- Associate a visible label with every input. The wrapped-label markup above is the standard pattern.
- Keep native state attributes such as `checked`, `required`, `disabled`, and validity in sync with the visual
  state classes.
- For nested groups, keep the parent input state synchronized with its child selections.

## Classes

Classes use BEM.

Base: `e-checkbox`

**Elements**

- `e-checkbox__mark`
- `e-checkbox__label`

**Modifiers**

- `e-checkbox--indeterminate`
- `e-checkbox--inverted`
- `e-checkbox--small`

**Pseudos**

- `e-checkbox---checked`
- `e-checkbox---disabled`
- `e-checkbox---disabled-checked`
- `e-checkbox---focus`
- `e-checkbox---hover`
- `e-checkbox---invalid`

## Examples

**Input:** Add a small checkbox for an optional setting.

**Output:**

```html
<label class="e-checkbox e-checkbox--small">
  <input type="checkbox" name="product-updates" />
  <span class="e-checkbox__mark"></span>
  <span class="e-checkbox__label">Send me product updates</span>
</label>
```

**Input:** Show a partially selected parent for a nested checkbox group.

**Output:**

```html
<fieldset class="e-strip-fieldset e-form-field">
  <legend class="e-form-field__label">Notifications</legend>
  <label class="e-checkbox">
    <input type="checkbox" name="notifications-all" />
    <span class="e-checkbox__mark"></span>
    <span class="e-checkbox__label">All notifications</span>
  </label>
  <div class="e-form-field__nested">
    <label class="e-checkbox">
      <input type="checkbox" name="notifications" value="email" />
      <span class="e-checkbox__mark"></span>
      <span class="e-checkbox__label">Email</span>
    </label>
    <label class="e-checkbox">
      <input type="checkbox" name="notifications" value="sms" />
      <span class="e-checkbox__mark"></span>
      <span class="e-checkbox__label">SMS</span>
    </label>
  </div>
</fieldset>
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall