HTML热力图需用CSS Grid布局+JS动态映射数据,以HSL配色(避免红绿过渡)、固定尺寸格子(min-width/height:12px)和伪元素显示数值,确保跨设备可识别。

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
HTML里没法直接画热力图,得靠CSS+JS组合实现
纯HTML没有绘图能力,所谓“热力图”本质是用格子(<div>或<code><span></span>)模拟日历单元,再通过CSS背景色深浅表达活跃度。关键不是“怎么写HTML”,而是怎么组织结构、怎么映射数据、怎么控制颜色梯度。
- 每个日期对应一个
<div class="cell">,用<code>data-date属性存真实日期(如2024-05-12) - 颜色不能硬编码——用JS读取贡献数后,动态加class(如
level-0到level-4),再由CSS定义各level的background-color - 别用
<table>布局:语义错、响应式难、格子对齐易出偏移;用<code>display: grid配grid-template-columns: repeat(7, 1fr)更稳CSS热力图配色要避开色盲陷阱,别只调opacity
很多人用同一色值+不同
opacity做深浅,结果在暗色背景或投影下完全看不出差异,且红绿色弱用户无法分辨。真正可用的方案是固定明度、调整饱和度和色相。- 推荐HSL模式:
hsl(180, 70%, 60%)(蓝)→hsl(180, 30%, 60%)(浅灰蓝),避免用红→绿过渡 - 至少提供3级颜色:0次=透明灰(
rgba(0,0,0,0.05)),1–3次=中等饱和,≥4次=高饱和,别设太多级——人眼分辨不出7种深浅 - 加
border: 1px solid rgba(0,0,0,0.05)让格子边界清晰,否则小尺寸下色块会“粘连”
JS注入数据时,日期必须标准化,否则跨月/跨年错位
用户给的原始数据通常是
{ "2024-05-12": 3, "2024-05-13": 1 }这种对象,但直接遍历key会丢失顺序,且无法处理当月首日不是周一的情况。- 先用
new Date(year, month, 1)算出当月1号是周几(getDay()返回0–6),补足前导空格格子 - 遍历当月每一天:用
date.toISOString().slice(0,10)统一成YYYY-MM-DD格式,再查数据对象——避免"5/12/2024"和"2024-05-12"匹配失败 - 别用
for...in遍历贡献对象:键顺序不保证,必须用Object.keys(data).sort()或直接按日期生成
静态图要防缩放失真,移动端格子最小宽度得设死
热力图在手机上一缩放,格子就挤成一条线,数字(如果有)全糊掉。这不是CSS媒体查询能全解决的,得从结构层约束。
立即学习“前端免费学习笔记(深入)”;
- 格子用
min-width: 12px+height: 12px(非em或rem),确保物理像素不坍缩 - 整行用
overflow-x: auto,禁用user-scalable=no——强制横滚比压扁强 - 如果需显示具体数值(如小角标),改用
::after伪元素+font-size: 10px,别塞进格子内容,否则换行破坏布局
真正的坑不在怎么画,而在怎么让每个格子在任意设备上都保持可识别的独立性——颜色、尺寸、间距三者必须绑定死,松一个,整张图就失效。
- 推荐HSL模式:


















