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

<mth-color-picker>

@methane-ui/ui~10.1 KB brotli (cold + Lit)~3.2 KB marginal

Form-associated color picker with HSL sliders, preset swatches, hex input, and feature-detected EyeDropper support.

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

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/color-picker"></script>
<mth-color-picker value="#2563eb"></mth-color-picker>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
valuevaluestring"#2563eb"Selected hex color string (e.g. #2563eb).
namenamestring""Form field name.
labellabelstring""Accessible field label.
openopenbooleanfalseWhether the color picker popover is open.
disableddisabledbooleanfalseDisables interaction.
readonlyreadonlybooleanfalsePrevents changing the color value.
requiredrequiredbooleanfalseMarks a color selection as required.

Events

EventDetail TypeDescription
mth-change{ value: string }Fired when the selected color 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
EnterbothTrigger or swatch button is focusedToggles popover or selects color swatch
EscapebothColor picker 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-color-picker.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(open), :state(disabled), :state(readonly), :state(dirty), :state(touched), :state(invalid).Conformance suite
i18nRoutes 7 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test