← All Components
<mth-citation-list>
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
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>import '@methane-ui/ai/citation-list';
import '@methane-ui/react';
export function Example() {
return <mth-citation-list orientation="horizontal">Example</mth-citation-list>;
}<script setup lang="ts">
import '@methane-ui/ai/citation-list';
</script>
<template>
<mth-citation-list orientation="horizontal">Example</mth-citation-list>
</template>import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@methane-ui/ai/citation-list';
import { MthCitationListDirective } from '@methane-ui/angular';
@Component({
standalone: true,
schemas: [CUSTOM_ELEMENTS_SCHEMA],
imports: [MthCitationListDirective],
template: `<mth-citation-list orientation="horizontal">Example</mth-citation-list>`,
})
export class ExampleComponent {}<script lang="ts">
import '@methane-ui/ai/citation-list';
import MthCitationList from '@methane-ui/svelte/MthCitationList.svelte';
</script>
<MthCitationList orientation="horizontal">Example</MthCitationList>Properties & Attributes
| Property | Attribute | Type | Default | Description |
|---|---|---|---|---|
citations | — | unknown[] | — | Array of { id?, index?, title, url, snippet?, domain? } citations. |
label | label | string | "" | Accessible region label for the citation list. |
orientation | orientation | 'horizontal' | 'vertical' | "horizontal" | Layout and arrow navigation orientation (horizontal | vertical). |
selectedId | selected-id | string | "" | Currently highlighted citation ID. |
Events
| Event | Detail Type | Description |
|---|---|---|
mth-select | { id: string; index: number; title: string; url: string } | Fired when a citation item is activated. |
APG Keyboard Matrix
| Key | Direction | When | Expected Behavior |
|---|---|---|---|
| ArrowRight | ltr | citation focused | moves focus to next citation (RTL flipped) |
| ArrowLeft | ltr | citation focused | moves focus to previous citation (RTL flipped) |
| Home | both | citation focused | moves focus to first citation |
| End | both | citation focused | moves focus to last citation |
Accessibility Checklist
| Category | Requirement | Verified By |
|---|---|---|
| aria | All aria-* IDREFs resolve within the same DOM root (ADR-003). | scanSameRootAria |
| focus | Focus ownership matches focusModel="none". | lint-plugin & spec-compiler |
| contrast | Renders legible borders, focus outlines, and selection indicators under forced-colors: active. | Playwright forced-colors matrix |
| keyboard | Implements all 4 APG keyboard transitions across LTR/RTL. | mth-citation-list.spec.test.ts |
| i18n | Routes 3 UI/ARIA strings through @methane-ui/core i18n catalog. | Locale context test |