热力图

<div class="chart-grid">  <div style="grid-column:1/-1">    <p class="chart-cap">近 26 周活跃热力图</p>    <div class="icen-chart" id="heatmap-demo"></div>  </div></div>

特性

• 渲染：renderHeatmap；7 行 × N 周网格
• 色阶：5 档
• 数据：精确日期或便捷数组两种喂法

接口

导出

renderHeatmap 共享行为模块，清单含族内导出

事件

icen:chart-legend-toggleicen:chart-legend-visibilityicen:chart-zoom detail 契约见 IcenEventMap；共享行为模块，清单含族内事件

类型

dist/behaviors/charts.d.mts（随 npm 包发布，含全部 JSDoc 约束）

安装

bun add @icen.ai/ui

pnpm add @icen.ai/ui

npm install @icen.ai/ui

yarn add @icen.ai/ui

一行引入该组件（CSS 与 behavior 自动带上，无需关心内部 CSS 文件名）：

import '@icen.ai/ui/kit/chart-heatmap';

也可以用脚手架直接打印引入行：

bunx --bun @icen.ai/ui add chart-heatmap

Astro 项目注意：kit 入口里的 CSS import 在页面 <script> 里会被 Astro 的 client bundle 摇掉——请改在布局 frontmatter 里引 CSS（import '@icen.ai/ui/components/chart-heatmap.css';），JS 行为仍可走 kit。Vite SPA / webpack 项目无此问题。

用法

import { renderHeatmap } from '@icen.ai/ui/kit/chart-heatmap';renderHeatmap(el, { values: 近180天数值数组, weeks: 26 });       // 便捷形态renderHeatmap(el, { data: [{ date: '2026-07-01', value: 5 }] }); // 精确日期形态