Skip to content
astrostyle v0.6.2

Forms

Native form controls with a class each: keyboard, validation and screen readers work as the browser intends. Wrap a control in ap-c-field for its label, hint and error.

Field and input 01

Sector or coordinates.

Five letters, no digits.

Read-only.

<div class="ap-c-field">
  <label class="ap-c-field__label" for="course">Course</label>
  <input class="ap-c-input" id="course" aria-describedby="course-hint">
  <p class="ap-c-field__hint" id="course-hint">Sector or coordinates.</p>
</div>

Errors: set aria-invalid="true" on the control and point aria-describedby at the ap-c-field__error text.

Tokens of field: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-field-gapvar(--ap-space-xs)
--ap-field-label-colorvar(--ap-text-muted)
--ap-field-hint-colorvar(--ap-text-subtle)
--ap-field-error-colorvar(--ap-danger-text)
Tokens of input: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-input-bgvar(--ap-inset)
--ap-input-fgvar(--ap-text)
--ap-input-border-colorvar(--ap-border)
--ap-input-hover-border-colorvar(--ap-border-strong)
--ap-input-focus-border-colorvar(--ap-focus)
--ap-input-invalid-border-colorvar(--ap-danger)
--ap-input-placeholder-colorvar(--ap-text-subtle)
--ap-input-heightvar(--ap-size-control)
--ap-input-padding-inlinevar(--ap-space-md)
--ap-input-radiusvar(--ap-radius-control)

Select and combobox 02

Start from a native <select>: it works without JavaScript and keeps posting its value with the form. Add data-ap-combobox and call autoInit() (or createCombobox()) to turn it into a searchable combobox; data-ap-creatable also accepts free text.

Type to filter, arrows to move, Enter to pick.

<select class="ap-c-input ap-c-select" id="ship" name="ship" data-ap-combobox>
  <option value="">Search the registry</option>
  <option value="heron">Night Heron</option>
</select>

<script type="module">
  import { autoInit } from 'astrostyle/js'
  autoInit(document)
</script>

Keyboard: type to filter, ↓/↑ to move (skipping disabled options), Enter to choose, Esc to close and restore, Alt+↓ to open. Events on the select: change, ap:change (detail: { value, label, created }), ap:open, ap:close. The native select stays the source of truth: options you add to it later show up the next time the list opens.

Tokens of select: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-select-chevron-colorvar(--ap-text-muted)
--ap-select-chevron-size0.375rem
Tokens of combobox: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-combobox-popup-bgvar(--ap-surface-1)
--ap-combobox-popup-border-colorvar(--ap-border)
--ap-combobox-popup-max-heightcalc(var(--ap-size-control) * 6)
--ap-combobox-option-active-bgcolor-mix(in oklab, var(--ap-accent) 16%, transparent)
--ap-combobox-option-selected-colorvar(--ap-link)
--ap-combobox-toggle-colorvar(--ap-text-muted)

Checkbox, radio, switch 03

Checkbox
Radio
Switch
<label class="ap-o-cluster"><input class="ap-c-checkbox" type="checkbox"> Shields</label>
<label class="ap-o-cluster"><input class="ap-c-radio" type="radio" name="thrust"> Cruise</label>
<label class="ap-o-cluster"><input class="ap-c-switch" type="checkbox" role="switch"> Autopilot</label>
Tokens of checkbox: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-checkbox-sizevar(--ap-size-icon)
--ap-checkbox-bgvar(--ap-inset)
--ap-checkbox-border-colorvar(--ap-border-strong)
--ap-checkbox-checked-bgvar(--ap-accent)
--ap-checkbox-mark-colorvar(--ap-on-accent)
--ap-checkbox-invalid-border-colorvar(--ap-danger)
--ap-checkbox-radiusvar(--ap-radius-control)
Tokens of radio: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-radio-sizevar(--ap-size-icon)
--ap-radio-bgvar(--ap-inset)
--ap-radio-border-colorvar(--ap-border-strong)
--ap-radio-checked-colorvar(--ap-accent)
--ap-radio-invalid-border-colorvar(--ap-danger)
Tokens of switch: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-switch-block-sizevar(--ap-size-icon)
--ap-switch-track-bgvar(--ap-surface-3)
--ap-switch-track-border-colorvar(--ap-border-strong)
--ap-switch-thumb-colorvar(--ap-text-muted)
--ap-switch-on-track-bgvar(--ap-accent)
--ap-switch-on-thumb-colorvar(--ap-on-accent)

Range 04

Tokens of range: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-range-track-sizevar(--ap-space-sm)
--ap-range-track-bgvar(--ap-surface-3)
--ap-range-thumb-sizevar(--ap-size-icon)
--ap-range-thumb-colorvar(--ap-accent)
--ap-range-thumb-border-colorvar(--ap-bg)

Segmented meter 05

Hull 3 / 8
Fuel 12 / 20
Shields 5 / 5
<div class="ap-c-meter ap-c-meter--danger" role="meter" aria-label="Hull"
     aria-valuemin="0" aria-valuemax="8" aria-valuenow="3"
     style="--ap-meter-value: 3; --ap-meter-max: 8"></div>

Keep aria-valuenow/aria-valuemax in sync with the two custom properties. Modifiers: --success, --warning, --danger.

Tokens of meter: set them on the element, on a parent or in a modifier.
TokenDefault
--ap-meter-value0
--ap-meter-max10
--ap-meter-fillvar(--ap-accent)
--ap-meter-trackvar(--ap-surface-3)
--ap-meter-gapvar(--ap-space-xxs)
--ap-meter-heightvar(--ap-space-sm)