D3.js
概览
D3.js 是一个底层 JavaScript 库,用于通过将数据绑定到 DOM 元素来构建自定义的交互式数据可视化。它提供比例尺、坐标轴、形状生成器、地理投影、力模拟和层次布局,让开发者完全控制视觉输出,同时通过计算的比例尺和布局与 React 集成。
使用说明
- 绑定数据时,使用
.data(dataset).join("element")(D3 v6+)来实现 enter/update/exit 模式,通过访问器函数从绑定数据中设置属性和样式。 - 创建比例尺时,选择合适的类型(连续型用
scaleLinear、分类条形图用scaleBand、日期用scaleTime、颜色映射用scaleOrdinal),并始终使用d3.extent()从数据中设置 domain。 - 构建坐标轴时,使用
d3.axisBottom(scale)或d3.axisLeft(scale)创建,配置刻度和标签格式(d3.format()),并在窗口大小变化时重新生成。 - 创建图表类型时,使用形状生成器(
d3.line()、d3.area()、d3.arc()、d3.pie()、d3.stack())和布局函数(d3.treemap()、d3.forceSimulation()、d3.geoPath())实现复杂可视化。 - 添加交互性时,使用过渡(
.transition().duration(750))实现平滑数据更新、悬停提示、刷选和缩放。 - 与 React 集成时,D3 负责数学计算(比例尺、布局、数据转换),React 负责 DOM 渲染,在
useMemo中计算值,在useEffect中结合 ref 实现 D3 驱动的动画。
示例
示例 1:构建包含多种图表类型的实时仪表板
用户请求: “根据 API 数据创建包含折线图、条形图和饼图的仪表板”
操作步骤:
- 使用
d3.scaleTime()和d3.scaleLinear()设置共享比例尺(x 轴和 y 轴) - 使用
d3.line()构建折线图,添加平滑曲线插值和面积填充 - 使用
d3.scaleBand()构建分组条形图,添加交错进入过渡动画 - 使用
d3.pie()和d3.arc()构建环形图,添加悬停提示
输出: 一个响应式仪表板,包含动画图表,数据变动时平滑更新。
示例 2:创建力导向网络图
用户请求: “将实体之间的关系可视化为交互式网络图”
操作步骤:
- 使用
d3.forceSimulation()设置力模拟,包含forceManyBody、forceLink和forceCenter - 使用
d3.scaleOrdinal()按类别着色,将节点渲染为圆 - 使用
d3.drag()添加拖拽交互,重新定位节点 - 使用
d3.zoom()实现缩放和平移,并添加悬停提示
输出: 一个交互式力导向图,包含可拖拽节点、颜色编码类别和缩放导航。
指南
- 在 React 应用中使用 D3 进行比例尺计算、布局和数据处理,由 React 负责 DOM 渲染。
- 使用
.join()代替手动 enter/update/exit,实现更简洁、更清晰的数据绑定。 - 始终使用
d3.extent()从数据中设置比例尺的 domain,而不是硬编码范围。 - 使用
d3.format()格式化轴标签和提示:千位数用",.0f",货币用"$.2f"。 - 添加 750ms 的过渡动画,配以
easeCubicInOut实现平滑数据更新动画。 - 在
ResizeObserver回调中重新计算比例尺,使可视化具有响应式。 - 为 SVG 元素添加
aria-label和有意义的<title>标签,提升可访问性。