Section cards
SectionCards lists your site's sections as cards, in your preset's home style.
<SectionCards> draws one card per section of your site, each listing its first pages — the section grid of a docs home. It's drawn by your preset's own home builders, so it looks native in all eight.
Doc engine v2 only (presets). A v1 site doesn't draw <SectionCards>: used empty it shows nothing, and any content inside it shows as plain text.
Used empty
With no children, it draws one card per header section, listing its first pages and how many there are. On a site with one section, it draws one card per sidebar group instead.
Used empty, it fills itself from your site. Give it content of its own and it shows only that. With no content and nothing on the site to fill it, it draws nothing and the build log says so:
With your own content
Each <Card title href> is a card. A link list inside a card becomes its items; any other text is its description, which every preset draws under the title. Paper and Grid show a count only for a card that lists links ("3 articles", "3 pages"); a card with only text reads Read more instead, and shows neither when it has no href. Workbench counts its links the same way.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
title | string | "Documentation" (Margin: "Reference") | Heading of the block, where the preset draws one — Plain and Margin do |
limit | number | 8 | Most cards shown |
In each preset
It's drawn in your preset's home style — or in the layout named by appearance.layout.home while that setting still works. Every preset has a slot for it. Atlas draws its product cards. On a page with the normal frame it sits in the content column; on a layout: wide page it runs across the page.
Example
This site's own, from <SectionCards />: