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

<mth-activity-feed>

@methane-ui/ui~9.0 KB brotli (cold + Lit)~2.6 KB marginal

Accessible activity stream (role="feed") supporting slotted items, imperative .items, and async DataSource<T> via DataController and SlotCollectionController.

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

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/activity-feed"></script>
<mth-activity-feed relative-time>Example</mth-activity-feed>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
items—ReadonlyArray<unknown> | nullnullImperative activity entries array.
dataSource—unknown | nullnullAsync DataSource<ActivityFeedEntry, string> backing the feed.
filterfilterstring""Filter string passed to DataController queries.
relativeTimerelative-timebooleantrueFormats timestamps using FormattingUtils.formatRelativeTime.
labellabelstring""Accessible label for the role="feed" region.
emptyTextempty-textstring""Custom empty-state message.
errorTexterror-textstring""Custom error-state message.
loadingTextloading-textstring""Custom loading-state message.

Events

EventDetail TypeDescription
mth-data-state{ status: unknown; count: number }Emitted when the underlying DataController transitions status.

Accessibility Checklist

CategoryRequirementVerified By
ariaAll aria-* IDREFs resolve within the same DOM root (ADR-003).scanSameRootAria
focusFocus ownership matches focusModel="none" with host role="feed".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(loading), :state(empty), :state(error).Conformance suite
i18nRoutes 5 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test