
本文介绍两种不修改原始数据语义的前提下,在 echarts 中高亮或差异化渲染 NULL 值的实用方案:一种通过添加哑变量维度配合 visualmap 控制样式,另一种利用双系列叠加实现“透明占位+标签标注”的视觉效果。
在数据可视化中,null 值常被默认忽略或隐式跳过,导致图表无法传达“缺失”这一关键信息。echarts 本身不会为 null 渲染柱状,但可通过巧妙的配置实现其显式表达——既保留原始数据完整性,又赋予缺失值可识别的视觉语义。
✅ 推荐方案:哑变量 + 双坐标轴 + 叠加系列(推荐)
该方案完全不篡改原始 null 值,而是引入一个独立的 dummy 数值维度(如设为固定非零值),并将其绑定到第二个隐藏的 x 轴上,再用 visualMap 单独控制该系列的视觉属性(颜色、透明度、亮度等)。这样,null 对应的柱子由第二系列“顶替”绘制,而主系列仍忠实反映真实数值(含空白缺口),形成语义清晰的对比。
const dataset = [ { day: 'Mon', value: 120, dummy: 0 }, { day: 'Tue', value: 70, dummy: 0 }, { day: 'Wed', value: null, dummy: 50 }, // ← null 行:主系列不绘,但 dummy=50 触发第二系列渲染 { day: 'Thu', value: 80, dummy: 0 }, { day: 'Fri', value: null, dummy: 50 }, { day: 'Sat', value: 110, dummy: 0 }, { day: 'Sun', value: 130, dummy: 0 } ]; option = { dataset: [{ dimensions: [ { name: 'day', type: 'ordinal' }, { name: 'value', type: 'number' }, { name: 'dummy', type: 'number' } // 哑变量:仅用于触发空值可视化 ], source: dataset }], xAxis: [ { type: 'category', position: 'bottom' }, // 主x轴:显示真实值(null 处留空) { type: 'category', position: 'bottom', show: false } // 辅助x轴:仅用于 dummy 系列定位 ], yAxis: {}, tooltip: { show: true }, visualMap: [ // 主系列:按 value 映射颜色(可选) { type: 'piecewise', seriesIndex: 0, show: false, dimension: 1, inRange: { color: ['#5470C6', '#91CC75'] } }, // 哑变量系列:专用于 null 标识 { type: 'piecewise', seriesIndex: 1, show: false, dimension: 2, inRange: { color: '#999', opacity: 0.25, colorLightness: 0.4 } } ], series: [ // 主系列:正常 bar,encode y → 'value';null 自动跳过 { type: 'bar', encode: { x: 'day', y: 'value' } }, // 哑变量系列:仅在 dummy > 0 时绘制浅灰半透柱,精准对应 null 位置 { type: 'bar', xAxisIndex: 1, encode: { x: 'day', y: 'dummy' } } ] };
? 优势说明: ✅ 零污染原始数据:value 字段保持 null,下游逻辑不受影响; ✅ 精准定位:dummy 值仅在需标识 null 的行设置,避免误标; ✅ 风格可控:通过 visualMap.inRange 自由调节透明度、颜色、明暗,甚至可扩展为带文字标签(配合 label 选项); ✅ 兼容性强:适用于所有支持 dataset 的 ECharts 图表类型(柱状图、折线图等)。
⚠️ 备选方案:布尔维度 + visualMap 分类映射
早期做法是将 null 转换为布尔标记(如 isNull: true),并作为独立维度传入 dataset,再用 piecewise visualMap 按类别控制 opacity 或 colorLightness。虽可行,但需预处理数据(将 null 显式转为 true/false),且当数据中存在 0 或其他假值时易混淆,语义不如哑变量方案严谨。
? 实践建议与注意事项
- 标签增强可读性:若需在 null 柱上显示“N/A”或“—”等文本,可在第二系列中启用 label:
series[1].label = { show: true, formatter: 'N/A', color: '#666', fontSize: 12 }; - 避免视觉干扰:哑变量系列的 y 值(如示例中的 50)应小于主系列最大值,防止遮挡或比例失真;也可统一设为 1 并通过 yAxis.scale = true 自适应。
- 响应式适配:当启用 dataset.source 动态更新时,确保 dummy 字段同步刷新,维持 null 位置一致性。
- 无障碍考量:为 null 柱补充 tooltip.formatter 自定义提示(如 “Missing data for {a0}”),提升可访问性。
通过上述方法,你不仅能“看见”缺失值,更能以专业、一致、可维护的方式将其融入数据叙事——让图表真正成为数据质量的镜子,而非过滤器。