Methane@methane-ui/*
CSS LayoutsComponentsSkillsTheme BuilderGitHub
← All Components

<mth-timezone-picker>

@methane-ui/ui~11.2 KB brotli (cold + Lit)~3.8 KB marginal

Form-associated IANA timezone selector powered by Intl.supportedValuesOf("timeZone"), UTC offset formatting, and ListboxController.

When NOT to use: Use a lightweight @methane-ui/css layout class instead of a custom element when static CSS suffices.

Live Interactive Preview

Interactive StageLive Custom Element · <mth-timezone-picker> (@methane-ui/ui)
Ready · interact with <mth-timezone-picker>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/timezone-picker"></script>
<mth-timezone-picker></mth-timezone-picker>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
valuevaluestring""Selected IANA timezone identifier (e.g. America/New_York or UTC).
namenamestring""Form field name.
labellabelstring""Accessible field label.
placeholderplaceholderstring""Placeholder shown when no timezone is selected.
openopenbooleanfalseWhether the timezone listbox popover is open.
disableddisabledbooleanfalseDisables interaction.
readonlyreadonlybooleanfalsePrevents changing the selected timezone.
requiredrequiredbooleanfalseMarks a timezone selection as required.

Events

EventDetail TypeDescription
mth-change{ value: string }Fired when the selected timezone changes.
mth-open{ open: true }Cancelable event fired before opening.
mth-after-open{ open: true }Fired after opening completes.
mth-close{ reason: string }Fired on close.
mth-after-close{ reason: string }Fired after close completes.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
ArrowDownbothTrigger or listbox is focusedOpens timezone popover and navigates options
EnterbothTimezone option is activeSelects active IANA timezone and closes popover
EscapebothTimezone popover is openCloses popover and restores focus

Accessibility Checklist

CategoryRequirementVerified By
ariaAll aria-* IDREFs resolve within the same DOM root (ADR-003).scanSameRootAria
focusdelegatesFocus: true with zero host internals.role (ADR-014).lint-plugin & spec-compiler
contrastRenders legible borders, focus outlines, and selection indicators under forced-colors: active.Playwright forced-colors matrix
keyboardImplements all 3 APG keyboard transitions across LTR/RTL.mth-timezone-picker.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(open), :state(disabled), :state(readonly), :state(dirty), :state(touched), :state(invalid).Conformance suite
i18nRoutes 2 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test