Sketchbook
On this page

Tag <sb-native-select> · status stable · version 0.1.0

Example

<div style="max-width:320px">
  <sb-native-select label="Region">
    <option value="">Choose a region</option>
    <option value="north">North</option>
    <option value="south">South</option>
    <option value="east">East</option>
  </sb-native-select>
</div>

Properties

Name Type Default Notes
label text Visible label and accessible name. Required: shadow DOM keeps external <label for> from reaching the inner select.
hideLabel boolean false Visually hides the label; it stays the accessible name.
description text `` Help text under the field.
errorMessage text `` Error message. Setting it marks the field invalid.
size medium, small medium Control height: medium 36px, small 32px.
name text `` Form field name.
value text `` Value of the selected option; submitted with the form. Without it, the option marked selected (else the first option) is the default restored by form reset.
required boolean false Native required: the selected option must have a non-empty value. Adds an aria-hidden asterisk after the label.
disabled boolean false Native disabled; dimmed; not submitted.

Events

Name Notes
input Each selection change. Native and composed, so it crosses the shadow boundary.
change Selection committed. Re-dispatched from the host because native change is not composed (NativeControl).

Keyboard

Key Does
Tab move focus in and out
Space / Enter / Alt+ArrowDown open the native popup (platform behavior)
ArrowUp / ArrowDown change or move through options (platform behavior)
typing jump to the option starting with the typed text

Accessibility

  • Role: combobox (a native single-selection <select>; listbox when size > 1)
  • Native element: select
  • Accessible name: The label prop, through a native <label for> in the same shadow root.
  • Form: ElementInternals: setFormValue(value), validity mirrored from the inner select (required -> valueMissing) with setValidity, formResetCallback restores the default selection, disabled is not submitted.

View as Markdown