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

<mth-loading-overlay>

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

Region or fullscreen loading overlay displaying an animated CSS spinner, aria-busy scrim, and localized status message over slotted content.

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-loading-overlay> (@methane-ui/ui)
Protected Workspace CardContent beneath the accessible status scrim.
Ready · interact with <mth-loading-overlay>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/loading-overlay"></script>
<mth-loading-overlay>Example</mth-loading-overlay>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
activeactivebooleanfalseControls whether the loading overlay scrim is displayed.
fullscreenfullscreenbooleanfalsePins the overlay across the full viewport (position: fixed).
labellabelstring""Optional message displayed below the spinner and announced to screen readers.
blurredblurredbooleanfalseApplies a subtle backdrop blur over underlying content when supported.

Events

EventDetail TypeDescription
mth-active-change{ active: boolean }Fired when the active loading state toggles.

Accessibility Checklist

CategoryRequirementVerified By
ariaAll aria-* IDREFs resolve within the same DOM root (ADR-003).scanSameRootAria
focusFocus ownership matches focusModel="none".lint-plugin & spec-compiler
contrastRenders legible borders, focus outlines, and selection indicators under forced-colors: active.Playwright forced-colors matrix
statesExposes ElementInternals CustomStateSet flags: :state(active), :state(fullscreen).Conformance suite
i18nRoutes 1 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test