LocaleSelect
A select-based locale switcher for multilingual forms, apps and documentation surfaces.
import { LocaleSelect } from "@schukai/monster/source/components/accessibility/locale-select.mjs";'%3E%3Cpath style='stroke:none;fill-rule:nonzero;fill:%23f03c2e;fill-opacity:1' d='M90.156 41.965 50.036 1.848a5.918 5.918 0 0 0-8.372 0l-8.328 8.332 10.566 10.566a7.03 7.03 0 0 1 7.23 1.684 7.034 7.034 0 0 1 1.669 7.277l10.187 10.184a7.028 7.028 0 0 1 7.278 1.672 7.04 7.04 0 0 1 0 9.957 7.05 7.05 0 0 1-9.965 0 7.044 7.044 0 0 1-1.528-7.66l-9.5-9.497V59.36a7.04 7.04 0 0 1 1.86 11.29 7.04 7.04 0 0 1-9.957 0 7.04 7.04 0 0 1 0-9.958 7.06 7.06 0 0 1 2.304-1.539V33.926a7.049 7.049 0 0 1-3.82-9.234L29.242 14.272 1.73 41.777a5.925 5.925 0 0 0 0 8.371L41.852 90.27a5.925 5.925 0 0 0 8.37 0l39.934-39.934a5.925 5.925 0 0 0 0-8.371'/%3E%3C/g%3E%3C/svg%3E "View source code")
Introduction
The Monster LocaleSelect offers language switching through a select-based control. Use it when locale choice should fit naturally into forms, settings areas or compact toolbars.
When to use LocaleSelect
- Use it when a select fits the surrounding UI: Settings forms and compact headers are common cases.
- Use it for predictable locale lists: A select works well when the available languages are explicit.
- Do not use it when a more prominent language switcher is needed: Public-facing language choice may deserve a stronger affordance.
Simple Language Switcher
A simple locale selector that redirects to the chosen language. The reset-cookie feature is disabled for this example.
Javascript
import '@schukai/monster/source/components/accessibility/locale-select.mjs';
const selector = document.createElement('monster-locale-select');
selector.setOption('labels.select-an-option', 'Select a language');
selector.setOption('features.resetCookie', false);
document.body.appendChild(selector);<script type="module">import '@schukai/monster/source/components/accessibility/locale-select.mjs';
const selector = document.createElement('monster-locale-select');
selector.setOption('labels.select-an-option', 'Select a language');
selector.setOption('features.resetCookie', false);
document.getElementById('locale-select-simple').appendChild(selector);</script>HTML
<div id="locale-select-simple"></div>Stylesheet
/** no additional stylesheet is defined **/Component Design
The locale select wraps monster-select and exports its parts to keep styling flexible. Use ::part() to align the control with your layout and theme.
Exported Parts
All standard select parts are exported, including control, popper, and selection.
monster-locale-select::part(control) {
min-width: 220px;
}
monster-locale-select::part(selection) {
padding: 0.2rem 0.4rem;
}
HTML Structure
<monster-locale-select></monster-locale-select>JavaScript Initialization
const element = document.createElement('monster-locale-select');
document.body.appendChild(element);Exported
LocalSelectorDerived from
CustomElementOptions
The Options listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class. Therefore, it inherits Options from these parent classes. If you cannot find a specific Options in this list, we recommend consulting the documentation of the CustomElement.
- since
- deprecated
Properties and Attributes
The Properties and Attributes listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class and ultimately from HTMLElement. Therefore, it inherits Properties and Attributes from these parent classes. If you cannot find a specific Properties and Attributes in this list, we recommend consulting the documentation of the CustomElement.
data-monster-options: Sets the configuration options for the collapse component when used as an HTML attribute.data-monster-option-[name]: Sets the value of the configuration option[name]for the collapse component when used as an HTML attribute.
Methods
The methods listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class and ultimately from HTMLElement. Therefore, it inherits methods from these parent classes. If you cannot find a specific method in this list, we recommend consulting the documentation of the CustomElement.
Static methods
[instanceSymbol]()exportparts()getCSSStyleSheet()- {CSSStyleSheet[]}
getTag()- {string}
Lifecycle methods
Lifecycle methods are called by the environment and are usually not intended to be called directly.
[assembleMethodSymbol]()- {LocaleSelect}
connectedCallback()Events
This component does not fire any public events. It may fire events that are inherited from its parent classes.