# Visitor Map Card

https://fieldbook.lizardi.mx/zh/components/visitor-map-stat-card

分类：数据展示
缩略图：https://fieldbook.lizardi.mx/thumbs/visitor-map-stat-card.webp

Visitor Map Card：宽版流量卡片以粗网格世界地图为基础，各区域按占比着色，悬停时标题切换为对应区域。

## 框架

react、vue、svelte、astro、html

## 预览控件

这些控件会传给演示组件。默认值和限制描述的是预览；完整的属性接口请查看实现代码。

| 名称 | 类型 | 默认值 | 选项或限制 |
| --- | --- | --- | --- |
| accentColor | color | #38BDF8 | 元数据未列出其他限制。 |
| cellSize | number | 6 | 范围 4 至 12；步长 1 |
| total | number | 148 | 范围 20 至 5000；步长 1 |
| trend | number | -3.1 | 范围 -40 至 40；步长 0.1 |
| title | text | Unique Visitors | 最多 40 个字符 |

## 使用说明

Visitor Map Card 的预览采用「宽幅」布局，主题设置为「浅色/深色」。

### Visitor Map Card 提供哪些框架版本？

Visitor Map Card 提供 React、Vue、Svelte、Astro、HTML 版本。实时预览使用 React；以下代码观察仅针对 index.tsx。使用其他版本前，请确认其交互行为。

### Visitor Map Card 有哪些依赖？

React 元数据列出的额外 npm 依赖为：motion。

### Visitor Map Card 的代码中有哪些无障碍细节？

Visitor Map Card 的 React 代码包含：属性与事件处理器（aria-hidden、aria-label、aria-live、onKeyDown、tabIndex）；显式角色（img）；按键比较（ArrowDown、ArrowLeft、ArrowRight、ArrowUp、Escape）。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。

### Visitor Map Card 如何处理减少动态效果的偏好？

Visitor Map Card 的 React 代码通过 matchMedia(prefers-reduced-motion) 读取动态效果偏好。请启用减少动态效果，检查完整实现、共享样式和所选框架版本；这些观察不能证明所有动画都会停止。

## 通过 MCP 安装

连接客户端，调用 get_component 获取实现，再调用 get_install_command 获取安装说明。选择已列出的框架，将源代码集成到应用中并验证功能。

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "visitor-map-stat-card",
    "framework": "react"
  }
}
```

[面向智能体](https://fieldbook.lizardi.mx/zh/docs/agents)
[MCP](https://fieldbook.lizardi.mx/api/mcp)

## 相关开放组件

- [Animated metric counter](https://fieldbook.lizardi.mx/zh/components/animated-metric-counter)
- [Counting number readout](https://fieldbook.lizardi.mx/zh/components/counting-number-readout)
- [Before/After Code Diff](https://fieldbook.lizardi.mx/zh/components/before-after-code-diff)
- [Billing Ledger Table](https://fieldbook.lizardi.mx/zh/components/billing-ledger-table)
- [Concentric goal rings](https://fieldbook.lizardi.mx/zh/components/concentric-goal-rings)
- [Credit balance ledger](https://fieldbook.lizardi.mx/zh/components/credit-balance-ledger)