close

OverviewGroup

OverviewGroup отображает сгруппированные карточки на страницах обзора, показывая список страниц и их якоря заголовков.

Использование

index.mdx
import { OverviewGroup } from '@rspress/core/theme';

const group = {
  name: 'Начало работы',
  items: [
    {
      text: 'Введение',
      link: '/guide/introduction',
      headers: [
        { id: 'what-is-rspress', text: 'Что такое Rspress' },
        { id: 'features', text: 'Возможности' },
      ],
    },
    {
      text: 'Установка',
      link: '/guide/installation',
    },
  ],
};

<OverviewGroup group={group} />;
Совет

Этот компонент обычно используется автоматически Rspress на страницах с overview: true в метаданных и не требует ручного вызова.

Прорсы

group

  • Тип: Group
  • Обязательный: Да
interface GroupItem {
  /** Item title */
  text: string;
  /** Item link */
  link: string;
  /** List of heading anchors within the page */
  headers?: Header[];
  /** Custom sub-items list */
  items?: { text: string; link: string }[];
}

interface Group {
  /** Group name */
  name: string;
  /** List of items in the group */
  items: GroupItem[];
}

interface Header {
  id: string;
  text: string;
  depth: number;
}
  • name - The group title, rendered as an h2 heading
  • items - List of pages in the group
  • headers - Heading anchors within each page, clicking navigates to the corresponding position
  • items (within GroupItem) - Custom sub-items, used to replace automatically extracted headers