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

<mth-citation-list>

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

Numbered AI source citation chips with strict https:/http: URL validation (ADR-012) and RTL-aware roving focus.

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

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ai/citation-list"></script>
<mth-citation-list orientation="horizontal">Example</mth-citation-list>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
citations—unknown[]—Array of { id?, index?, title, url, snippet?, domain? } citations.
labellabelstring""Accessible region label for the citation list.
orientationorientation'horizontal' | 'vertical'"horizontal"Layout and arrow navigation orientation (horizontal | vertical).
selectedIdselected-idstring""Currently highlighted citation ID.

Events

EventDetail TypeDescription
mth-select{ id: string; index: number; title: string; url: string }Fired when a citation item is activated.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
ArrowRightltrcitation focusedmoves focus to next citation (RTL flipped)
ArrowLeftltrcitation focusedmoves focus to previous citation (RTL flipped)
Homebothcitation focusedmoves focus to first citation
Endbothcitation focusedmoves focus to last citation

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
keyboardImplements all 4 APG keyboard transitions across LTR/RTL.mth-citation-list.spec.test.ts
i18nRoutes 3 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test