PostList

Publishing · src/components/PostList/PostList.tsx

An index of published stories: a lead, then the rest.

Year grouping emits a real section per year with its own heading and aria-labelledby, and the items inside drop to h3. The grouping is therefore in the document rather than in the spacing, so an archive can be navigated by heading instead of by scrolling and guessing where one year ends.

lead={false} exists because promotion is editorial. On a page where the newest item is not the most important one, a hard-coded lead would make that claim anyway.

Renders null when empty rather than an empty list element.

Import

import { PostList } from '@redrob-labs/ui';

Rendered

The design system's own preview case, run against this package's build. The parity gate compares this rendering to the reference bundle's.

Props

Prop	Type	Notes
items	PubStory[]
lead	boolean	Pass false on a page where the first item must not be promoted.
group	'year'	'year' breaks the rest into year sections with real headings.
className	string