Skip to main content
ShadcnUI
Navigation

Enhanced Select

A capability-gated presentation over the same native select value.

When to use it. Use it when its native HTML meaning matches the caller-owned form requirement.

Native baseline Explicit identity takes precedence over FormField values. Protected identity and ARIA relationships cannot be contradicted through global attributes. Exact fallback Unsupported or CSS-disabled browsers keep the exact visible classic native select and value.

How it works

  • <.enhanced_select> Explicit identity takes precedence over FormField values. Protected identity and ARIA relationships cannot be contradicted through global attributes.
  • package CSS Package CSS applies scoped shadcn-style tokens, layout, focus, and state presentation without changing the native contract.
  • gallery only Theme switching, source copying, search, fixtures, and inspection controls on this page belong to the gallery only; :enhanced_select does not ship them.
  • application boundary Use Native Select for the dependable platform picker. Choose Enhanced Select only when its optional presentation is useful; country values, reset, and submission stay identical.

Examples use package semantic tokens in explicit light and dark scopes.

Accessibility and browser support

Visible labels and deterministic help and error relationships preserve the native accessible name and description contract.

Enhanced Select support and fallback
Feature Locked-engine evidence When missing
Native baseline Reviewed in the locked Chromium, Firefox, and WebKit evidence matrix. Unsupported or CSS-disabled browsers keep the exact visible classic native select and value.
Exact fallback The locked-engine matrix retains the documented native or static outcome. Unsupported or CSS-disabled browsers keep the exact visible classic native select and value.

Application ownership and API

The application owns changesets, translation, validation timing, submission, persistence, authorization, pending transitions, focus, and outcomes.

Choosing the related control. Use Native Select for the dependable platform picker. Choose Enhanced Select only when its optional presentation is useful; country values, reset, and submission stay identical.

Public API Package source

Provenance

Catalogue identity forms.enhanced_select, adapted from unscripted/ui commit bd8f403030c8d1f46804da6eda733fde7e908e63 under its MIT notice.

The documentation presentation is adapted locally; ShadcnUI's Phoenix API and native semantic contract remain authoritative.

Adapt the standards-based customizable-select structure and presentation into a capability-gated HEEX API over the exact visible native fallback.