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

<mth-load-more>

@methane-ui/ui~7.9 KB brotli (cold + Lit)~2.0 KB marginal

Explicit load-more pagination control integrating DataController cursor appending, progress summary, error retry, and standalone cancelable mth-load-more dispatch.

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

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/load-more"></script>
<mth-load-more loaded-count="0" total-count="0">Example</mth-load-more>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
loadingloadingbooleanfalseReflects or forces the loading state.
completecompletebooleanfalseMarks the collection as fully loaded.
disableddisabledbooleanfalsePrevents manual load-more and retry triggers.
loadedCountloaded-countnumber0Optional explicit count of currently loaded items when not bound to dataSource.
totalCounttotal-countnumber0Optional explicit total count of items when not bound to dataSource.
dataSource—unknown | nullnullOptional DataSource<T> connected to DataController.
renderItem—(item: unknown, index: number) => unknown—Optional custom renderer for items returned by DataController.

Events

EventDetail TypeDescription
mth-load-more{ cursor: string | null }Cancelable event emitted when the user activates load-more or retry.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
EnterbothLoad-more or retry button is focusedTriggers loading the next page of items
SpacebothLoad-more or retry button is focusedTriggers loading the next page of items

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-load-more.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(loading), :state(complete), :state(disabled), :state(error), :state(empty).Conformance suite
i18nRoutes 7 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test