Native Select Field

Accessible grouped native select with a label, description, invalid state, and mobile device picker.

Forms · Astro · Subscription · commercial licence · v1.0.0 · updated 2026-10-15 · Live demo

Install

velocityx add standard-native-select-field

Subscription component. Run velocityx login with your key first — get one.

---
import NativeSelectField from '../components/velocity/standard-native-select-field/NativeSelectField.astro';
---
<NativeSelectField />

Props

Prop	Type	Default	Description
`name`	`string`	required	—
`label`	`string`	required	—
`options`	`Option[]`	`[]`	—
`groups`	`Group[]`	`[]`	—
`id`	`string`	`native-select-${globalThis.crypto?.randomUUID?…`	—
`placeholder`	`string`	`'Choose an option'`	—
`defaultValue`	`string`	`''`	—
`description`	`string`	—	—
`error`	`string`	—	—
`required`	`boolean`	`false`	—
`disabled`	`boolean`	`false`	—
`className`	`string`	`''`	—

Files written

velocityx drops these into your project:

components/velocity/standard-native-select-field/NativeSelectField.astro

Peer dependencies

None.

Theming

Colours come from the primary-* / accent-* Tailwind scales, so this drops into a project that is not Velocity without dragging our brand in. Install the contract once:

velocityx theme

Then set your whole brand in one place — raw RGB channels, not hex (a hex here silently breaks every opacity variant):

:root {
  --vx-brand: custom;
  --vx-primary-600: 220 38 38;
}

There is no component-level font-family anywhere in the library — your font cascade wins.

Licence

Commercial, for the duration of an active Velocity X subscription. The source is served by the licence-gated endpoint, never by the public CDN.