# Activity cell heatmap

https://fieldbook.lizardi.mx/zh/components/activity-cell-heatmap

分类：图表
缩略图：https://fieldbook.lizardi.mx/thumbs/activity-cell-heatmap.webp

Activity cell heatmap：由浅色小方块组成的日历网格，以对角波浪效果入场，可通过等级条单独查看某一强度。

## 框架

react、vue、svelte、astro、html

## 预览控件

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

| 名称 | 类型 | 默认值 | 选项或限制 |
| --- | --- | --- | --- |
| accent | color | #9BE15D | 元数据未列出其他限制。 |
| weeks | number | 30 | 范围 12 至 53；步长 1 |
| gap | number | 2 | 范围 1 至 6；步长 1 |
| cornerRadius | number | 2 | 范围 0 至 6；步长 1 |
| weekStart | select | sunday | 选项：sunday、monday |
| interactive | boolean | true | 元数据未列出其他限制。 |

## 使用说明

使用此日历热力图查看紧凑的活动展示，包含五档强度和共享颜色图例。

Activity cell heatmap 的预览采用「宽幅」布局，主题设置为「浅色/深色」。

调整周数和每周起始日，比较控制台布局。启用交互后，悬停或聚焦某一天即可查看读数。

此实现围绕固定日期生成可复现的示例活动。将其作为实时活动报告使用前，请接入真实数据并更新日期模型。

### Activity cell heatmap 提供哪些框架版本？

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

### Activity cell heatmap 有哪些依赖？

React 元数据列出的额外 npm 依赖为：motion、clsx、tailwind-merge。

### Activity cell heatmap 的代码中有哪些无障碍细节？

Activity cell heatmap 的 React 代码包含：原生元素（button）；属性与事件处理器（aria-hidden、aria-label、onKeyDown、tabIndex）；按键比较（ArrowDown、ArrowLeft、ArrowRight、ArrowUp）。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。

### Activity cell heatmap 如何处理减少动态效果的偏好？

Activity cell heatmap 的 React 代码通过 useReducedMotion() 读取动态效果偏好。index.tsx 中随偏好变化的表达式：duration: reduce ? 0 : 0.12；isActive && !reduce ? "scale(1.26)" : "scale(1)"；transitionDelay: !reduce && ready && !revealed ? \`$\{((cell.col + cell.row) \* stepMs).toFixed(0)\}ms\` : "0ms"。请启用减少动态效果，检查完整实现、共享样式和所选框架版本；这些观察不能证明所有动画都会停止。

## 通过 MCP 安装

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

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "activity-cell-heatmap",
    "framework": "react"
  }
}
```

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

## 相关开放组件

- [Spoke area chart](https://fieldbook.lizardi.mx/zh/components/spoke-area-chart)
- [Vertex Dot Radar](https://fieldbook.lizardi.mx/zh/components/vertex-dot-radar-chart)
- [Animated Time Axis](https://fieldbook.lizardi.mx/zh/components/animated-time-axis)
- [Area chart lite](https://fieldbook.lizardi.mx/zh/components/area-chart-lite)
- [Candle Price Chart](https://fieldbook.lizardi.mx/zh/components/candle-price-chart)
- [Concentric Ring Chart](https://fieldbook.lizardi.mx/zh/components/concentric-ring-chart)