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.
| Token | Default |
|---|---|
--ap-field-gap | var(--ap-space-xs) |
--ap-field-label-color | var(--ap-text-muted) |
--ap-field-hint-color | var(--ap-text-subtle) |
--ap-field-error-color | var(--ap-danger-text) |
| Token | Default |
|---|---|
--ap-input-bg | var(--ap-inset) |
--ap-input-fg | var(--ap-text) |
--ap-input-border-color | var(--ap-border) |
--ap-input-hover-border-color | var(--ap-border-strong) |
--ap-input-focus-border-color | var(--ap-focus) |
--ap-input-invalid-border-color | var(--ap-danger) |
--ap-input-placeholder-color | var(--ap-text-subtle) |
--ap-input-height | var(--ap-size-control) |
--ap-input-padding-inline | var(--ap-space-md) |
--ap-input-radius | var(--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.
| Token | Default |
|---|---|
--ap-select-chevron-color | var(--ap-text-muted) |
--ap-select-chevron-size | 0.375rem |
| Token | Default |
|---|---|
--ap-combobox-popup-bg | var(--ap-surface-1) |
--ap-combobox-popup-border-color | var(--ap-border) |
--ap-combobox-popup-max-height | calc(var(--ap-size-control) * 6) |
--ap-combobox-option-active-bg | color-mix(in oklab, var(--ap-accent) 16%, transparent) |
--ap-combobox-option-selected-color | var(--ap-link) |
--ap-combobox-toggle-color | var(--ap-text-muted) |
Checkbox, radio, switch 03
<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>
| Token | Default |
|---|---|
--ap-checkbox-size | var(--ap-size-icon) |
--ap-checkbox-bg | var(--ap-inset) |
--ap-checkbox-border-color | var(--ap-border-strong) |
--ap-checkbox-checked-bg | var(--ap-accent) |
--ap-checkbox-mark-color | var(--ap-on-accent) |
--ap-checkbox-invalid-border-color | var(--ap-danger) |
--ap-checkbox-radius | var(--ap-radius-control) |
| Token | Default |
|---|---|
--ap-radio-size | var(--ap-size-icon) |
--ap-radio-bg | var(--ap-inset) |
--ap-radio-border-color | var(--ap-border-strong) |
--ap-radio-checked-color | var(--ap-accent) |
--ap-radio-invalid-border-color | var(--ap-danger) |
| Token | Default |
|---|---|
--ap-switch-block-size | var(--ap-size-icon) |
--ap-switch-track-bg | var(--ap-surface-3) |
--ap-switch-track-border-color | var(--ap-border-strong) |
--ap-switch-thumb-color | var(--ap-text-muted) |
--ap-switch-on-track-bg | var(--ap-accent) |
--ap-switch-on-thumb-color | var(--ap-on-accent) |
Range 04
| Token | Default |
|---|---|
--ap-range-track-size | var(--ap-space-sm) |
--ap-range-track-bg | var(--ap-surface-3) |
--ap-range-thumb-size | var(--ap-size-icon) |
--ap-range-thumb-color | var(--ap-accent) |
--ap-range-thumb-border-color | var(--ap-bg) |
Segmented meter 05
<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.
| Token | Default |
|---|---|
--ap-meter-value | 0 |
--ap-meter-max | 10 |
--ap-meter-fill | var(--ap-accent) |
--ap-meter-track | var(--ap-surface-3) |
--ap-meter-gap | var(--ap-space-xxs) |
--ap-meter-height | var(--ap-space-sm) |