<div class="kw-specimen-row">
<label class="kw-field"><span class="kw-label">Time of day</span><span class="kw-select-wrap"><select class="kw-select"><option>Day</option><option selected>Night</option><option>Dawn</option><option>Dusk</option><option>Continuous</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-hint">Prints in Scene 12’s heading.</span></label>
<label class="kw-field"><span class="kw-label">What it follows</span><span class="kw-select-wrap"><select class="kw-select"><optgroup label="Shoot"><option>First shooting day</option><option selected>Last shooting day</option></optgroup><optgroup label="Post"><option>Picture lock</option><option>Final mix</option></optgroup></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span></label>
</div>
<div class="kw-specimen-row">
<label class="kw-field"><span class="kw-label">Location for Day 7</span><span class="kw-select-wrap"><select class="kw-select" aria-invalid="true"><option selected>Choose a location</option><option>Lumen Studios</option><option>Street outside the lab</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-error" role="alert"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 8v4M12 16h.01"/></svg>Choose a location before issuing the call sheet.</span></label>
<label class="kw-field"><span class="kw-label">Paper</span><span class="kw-select-wrap"><select class="kw-select" disabled><option selected>A4</option><option>US Letter</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-hint">Set by the production for every script.</span></label>
</div>
What it is
The app’s Select (components/ui/Select.tsx) is a native <select> with its own box and a 14px ChevronDown drawn over it. The native element is the point: on a phone it opens the system wheel or sheet, which is better than anything drawn in a page, and keyboard and screen reader support come free.
Choosing the control
| Options | Use |
|---|---|
| 2–3, worth seeing at once | Segmented control or radios |
| 4–15 | Select |
| More, or answers people type | Combobox |
| Several at once | Multiselect |
Kwark examples
- Time of day for a scene heading: Day, Night, Dawn, Dusk, Continuous, in that order (how scene headings are written), not alphabetical.
- What it follows on a calendar date: option groups (Shoot, Post) keep a long list scannable.
- Paper: A4 or US Letter. In a form it is a select; in Settings it is a radio pair with each paper’s line count.
Behaviour
- Changing the value applies when the form is saved, unless the select sits in a settings row that applies at once (then say so).
- A select that must be chosen starts on a prompt option (Choose a location) that is not a valid value; the error says what it blocks.
- Disabled selects say why next to them. If someone cannot change it, prefer showing the value as text.
Time of day · Night with a drawn chevron, and the phone’s own picker when tapped.
A div-built dropdown that cannot be opened from the keyboard and scrolls inside a tiny box on a phone.
Anatomy
- Box: the Text input box: 36px, 1px
--k-line, 6px corners, 7px 10px padding, 34px kept on the right. The app’s component uses 12px padding and 8px corners (p-3 rounded-lg); the system box is the target. - Chevron: 14px, stroke 2,
--k-text-2, 12px from the right,pointer-events: noneso the click reaches the select. - Label: 500 12px
--k-text, sentence case. The app’s label is still upper case with wide tracking; move it to.kw-labelwhen touched (Rule 3 bans all-caps labels). - Option groups:
<optgroup>with sentence-case names.
States
| State | Look |
|---|---|
| Hover | Edge steps to --k-line-strong. |
| Focus | Edge --k-accent-soft, 2px ring 2px off. |
| Error | aria-invalid="true": --k-danger edge; message under it with an alert glyph. |
| Disabled | 50% opacity, chevron too, not-allowed cursor, reason as a hint. |
| Phone | 16px text so iOS does not zoom; 44px tall. |
Tokens
| Token | Light | Dark |
|---|---|---|
--k-surface |
#ffffff | #1a1a1a |
--k-bg |
#f8fafc | #191919 |
--k-line |
#e2e8f0 | rgba(255, 255, 255, .1) |
--k-line-strong |
var(–k-text-2) | var(–k-text-2) |
--k-text |
#0f172a | #e3e3e3 |
--k-text-2 |
#5b6779 | #9ca3af |
--k-accent-soft |
#e8b58b | #e8b58b |
--k-danger |
#b4382c | #e0685c |
--k-control-md |
36px | |
--k-radius-control |
6px |
React
In the Kwark app: import Select from '@/components/ui/Select'.
<Select label="Time of day" value={tod} onChange={setTod}
options={[{ value: 'DAY', label: 'Day' }, { value: 'NIGHT', label: 'Night' },
{ value: 'DAWN', label: 'Dawn' }, { value: 'DUSK', label: 'Dusk' }, { value: 'CONTINUOUS', label: 'Continuous' }]} />
| Prop | Type | Notes |
|---|---|---|
label |
string |
Visible label, tied to the select by id. |
options |
{ value: string; label: string }[] |
In the order people expect, not alphabetical by default. |
value |
string |
The current value. |
onChange |
(value: string) => void |
Receives the value, not the event. |
...rest |
SelectHTMLAttributes |
disabled, aria-invalid, aria-describedby pass through. |
HTML and CSS
Works anywhere with kwark.css.
<div class="kw-specimen-row">
<label class="kw-field"><span class="kw-label">Time of day</span><span class="kw-select-wrap"><select class="kw-select"><option>Day</option><option selected>Night</option><option>Dawn</option><option>Dusk</option><option>Continuous</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-hint">Prints in Scene 12’s heading.</span></label>
<label class="kw-field"><span class="kw-label">What it follows</span><span class="kw-select-wrap"><select class="kw-select"><optgroup label="Shoot"><option>First shooting day</option><option selected>Last shooting day</option></optgroup><optgroup label="Post"><option>Picture lock</option><option>Final mix</option></optgroup></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span></label>
</div>
<div class="kw-specimen-row">
<label class="kw-field"><span class="kw-label">Location for Day 7</span><span class="kw-select-wrap"><select class="kw-select" aria-invalid="true"><option selected>Choose a location</option><option>Lumen Studios</option><option>Street outside the lab</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-error" role="alert"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 8v4M12 16h.01"/></svg>Choose a location before issuing the call sheet.</span></label>
<label class="kw-field"><span class="kw-label">Paper</span><span class="kw-select-wrap"><select class="kw-select" disabled><option selected>A4</option><option>US Letter</option></select><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="kw-hint">Set by the production for every script.</span></label>
</div>
Keyboard
Native: Tab to focus; Space or Alt + Down opens; arrows move; typing jumps to an option; Enter chooses; Escape closes.
Rules
- The visible label is a real
<label>(the component ties it withuseId). - Errors and hints are tied with
aria-describedby. - The chevron is
aria-hidden. - Never rebuild a select from divs to get a custom look; style the box and leave the list to the platform.
Rules
- Must use the native
<select>through the sharedSelectfor single choices from four to fifteen options. - Never use a select for three or fewer options; show them with a segmented control or radios.
- Always order options the way people say them (Day, Night, Dawn, Dusk), not alphabetically by default.
- Must draw the chevron as a 14px SVG that ignores pointer events; never type ▾ or ⌄.
- Always say why a select is disabled, next to it.
AI readiness test
Task. Let a person choose a scene’s time of day in the scene heading editor.
Give the agent. Select, Segmented control.
Constraint. Values are Day, Night, Dawn, Dusk, Continuous.
A reliable answer
- Uses the shared Select (five options)
- Visible sentence-case label
- Options in scene-heading order
- Native element with drawn chevron