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

<mth-resizable-handle>

@methane-ui/ui~6.8 KB brotli (cold + Lit)~1.4 KB marginal

Draggable and keyboard-accessible separator handle for <mth-resizable-group>.

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

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/resizable-handle"></script>
<mth-resizable-handle orientation="horizontal" step="5">Example</mth-resizable-handle>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
orientationorientation'horizontal' | 'vertical'"horizontal"Group layout axis (horizontal or vertical).
disableddisabledbooleanfalseDisables drag and keyboard resizing.
stepstepnumber5Arrow key increment in percentage points.
valueNowvalue-nownumber50Current separator ARIA value.
valueMinvalue-minnumber0Minimum separator ARIA value.
valueMaxvalue-maxnumber100Maximum separator ARIA value.
labellabelstring""Accessible aria-label for the separator.

Events

EventDetail TypeDescription
mth-resize-delta{ deltaPercent?: number; deltaPx?: number; edge?: 'min' | 'max'; source: 'keyboard' | 'pointer' }Bubbles resize deltas to parent <mth-resizable-group>.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
ArrowLeftbothHorizontal handle is focusedEmits negative inline resize delta
ArrowRightbothHorizontal handle is focusedEmits positive inline resize delta
ArrowUpbothVertical handle is focusedEmits negative block resize delta
ArrowDownbothVertical handle is focusedEmits positive block resize delta
HomebothHandle is focusedRequests collapsing/minimizing preceding panel
EndbothHandle is focusedRequests maximizing preceding panel

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 6 APG keyboard transitions across LTR/RTL.mth-resizable-handle.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(disabled), :state(dragging).Conformance suite
i18nRoutes 1 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test