# LinkCard

链接样式的卡片，可选前置图标、标题和描述。悬停时标题和图标会变为主色。

**Install:** `nimbus-docs add link-card`  
**Source:** `src/components/ui/link-card/`  
**Canonical:** https://nimbus-docs.cn/components/link-card/

## Agent payload (JSON)

```json
{
  "slug": "link-card",
  "name": "LinkCard",
  "description": "Card whose entire surface is a link.",
  "tagline": "链接样式的卡片，可选前置图标、标题和描述。悬停时标题和图标会变为主色。",
  "install": "nimbus-docs add link-card",
  "sourcePath": "src/components/ui/link-card/",
  "canonicalUrl": "https://nimbus-docs.cn/components/link-card/",
  "props": [
    {
      "name": "title",
      "type": "string",
      "required": true,
      "description": "作为卡片标签渲染的标题。"
    },
    {
      "name": "description",
      "type": "string",
      "required": false,
      "description": "标题下方的可选副标题。"
    },
    {
      "name": "href",
      "type": "string",
      "required": true,
      "description": "目标 URL——整个卡片即为链接。"
    },
    {
      "name": "icon",
      "type": "string",
      "required": false,
      "description": "可选的 Iconify 图标名称（如 `ph:rocket-launch`），渲染在标题前方。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```