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

<mth-datetime-picker>

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

Combined date and time picker outputting ISO YYYY-MM-DDTHH:MM values with CalendarCore and time selection.

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-datetime-picker> (@methane-ui/ui)
Ready · interact with <mth-datetime-picker>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/datetime-picker"></script>
<mth-datetime-picker placeholder="YYYY-MM-DDTHH:MM"></mth-datetime-picker>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
valuevaluestring""ISO local datetime value (YYYY-MM-DDTHH:MM).
namenamestring""Form field name.
labellabelstring""Accessible field label.
placeholderplaceholderstring"YYYY-MM-DDTHH:MM"Input placeholder text.
openopenbooleanfalseWhether the datetime popover is open.
disableddisabledbooleanfalseDisables interaction.
readonlyreadonlybooleanfalsePrevents changing the datetime.
requiredrequiredbooleanfalseMarks a datetime value as required.

Events

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

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
ArrowDownbothTrigger or input is focusedOpens datetime popover
EscapebothDatetime 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 2 APG keyboard transitions across LTR/RTL.mth-datetime-picker.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(open), :state(disabled), :state(readonly), :state(dirty), :state(touched), :state(invalid).Conformance suite
i18nRoutes 5 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test