磁贴

使用 tiles 组件在响应式网格布局中展示带有图片缩略图、标题和描述的视觉预览。

使用磁贴来创建带有图案背景、标题和说明的视觉展示元素。磁贴非常适合在网格布局中展示组件预览、功能亮点或导航项。

磁贴标题

简短描述

Tile example

<Tile href="/your-link" title="Tile title" description="Short description">
  <img src="/images/your-preview-light.svg" alt="Tile preview" className="block dark:hidden" />
  <img src="/images/your-preview-dark.svg" alt="Tile preview (dark mode)" className="hidden dark:block" />
</Tile>

磁贴的 children 可以是任何你想在预览区域中显示的图片、SVG 或其他 React 节点。使用 block dark:hidden 和 hidden dark:block 工具类分别提供浅色和深色模式资源，使预览与当前主题相匹配。

​

网格布局

将磁贴与 Columns 组件 组合使用，以创建响应式的视觉预览网格。

磁贴一

简短描述

磁贴二

简短描述

磁贴三

简短描述

Grid layout example

<Columns cols={3}>
  <Tile href="/link-one" title="Tile one" description="Short description">
    <img src="/images/preview-one-light.svg" alt="Tile preview" className="block dark:hidden" />
    <img src="/images/preview-one-dark.svg" alt="Tile preview (dark mode)" className="hidden dark:block" />
  </Tile>
  <Tile href="/link-two" title="Tile two" description="Short description">
    <img src="/images/preview-two-light.svg" alt="Tile preview" className="block dark:hidden" />
    <img src="/images/preview-two-dark.svg" alt="Tile preview (dark mode)" className="hidden dark:block" />
  </Tile>
  <Tile href="/link-three" title="Tile three" description="Short description">
    <img src="/images/preview-three-light.svg" alt="Tile preview" className="block dark:hidden" />
    <img src="/images/preview-three-dark.svg" alt="Tile preview (dark mode)" className="hidden dark:block" />
  </Tile>
</Columns>

​

属性

href · string · 必填

点击卡片时要跳转到的 URL。

title · string

显示在卡片预览下方的标题。

description · string

显示在标题下方的简短说明。

children · React.ReactNode · 必填

显示在卡片预览区域的内容，通常为图片或 SVG 图像。