---
url: /3d/bar3d.md
---
# 三维柱状图 bar3d

类目 × 系列的数值矩阵立在网格上：x 轴类目、进深方向堆系列、柱高即数值，转动视角可从
任意角度对比组内与组间。

## 何时使用

* 多系列多类目，既要组内对比又要整体形体感；
* 汇报、大屏等需要「一眼立体」的场景；
* 需要逐格精确读数、类目很多时，[二维柱状图](/chart/bar)通常更合适。

## 示例

基础分组柱林：

柱体瘦一些、配背墙增强深度参照：

## 配置要点

* `bar.width` / `bar.depth`：柱体占带位的比例（0–1），多系列密排时调小防拥挤；
* `bar.shadow: false` 关掉柱底贴地阴影；
* 缺失值（null / NaN）不占位，零值柱保留；
* 数值轴名写进 `zAxis.name`，轴名会在防碰撞后贴在刻度外侧。

## 相关

* 相机与事件：[相机与交互](/3d/camera)
* 换色系：[主题接入](/3d/theme)
* 字段细节：[API 参考](/3d/api)