Velocity X Components

Standard Navigation

Locale / Region Switcher

A language-and-region picker for footers and headers that shows the current selection as plain text, never a flag — flags map to countries, not languages, and break down the moment one language spans several regions.

Subscription Included with the Velocity Components subscription.
bash
$ velocityx add standard-locale-region-switcher

Built for react. Needs react already installed as a peer dependency. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Locale / Region Switcher →

Needs a licence key — subscribe here, then velocityx loginonce.

react v1.0.1 react
Locale / Region Switcher

Props

NameTypeRequiredDefaultDescription
options{ id: string, language: string, region?: string, code: string }[]No[]
valuestringYesselected option id
onChange(id: string) => voidYes
labelstringNo'Language and region'accessible name for the trigger
align'left' | 'right'No'right'panel alignment
classNamestringNo''

File this creates

The CLI writes this path into your project, relative to its root — nothing else moves.

text
components/velocity/standard-locale-region-switcher/LocaleRegionSwitcher.jsx

Using the Locale / Region Switcher component

Install it with velocityx add standard-locale-region-switcher. The CLI writes the source straight into your project — no runtime dependency, no registry lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.

More from Standard Navigation.