@visx/shape 和 @vx/shape 是基于 D3 的 React 可视化组件库,前者是后者的现代维护版本。d3-shape 是底层的 vanilla JS 库,用于生成 SVG 路径数据,不依赖任何框架。react-simple-maps 则是专门用于构建交互式地图的 React 组件库,底层同样依赖 D3 的地理投影功能。这些工具共同解决了在 Web 上绘制复杂图形和地图的需求,但抽象层级和适用场景各不相同。
在 React 生态中构建数据可视化时,开发者常面临选择:是直接使用底层的 d3-shape,还是使用封装好的 React 组件如 @visx/shape?此外,旧版的 @vx/shape 和专用的 react-simple-maps 又该如何定位?本文将深入对比这些库的架构、开发体验及适用场景。
@vx/shape 是 Airbnb 早期发布的可视化库命名空间。
@visx/shape。// @vx/shape: 已废弃,切勿在新项目中使用
import { Arc } from '@vx/shape';
// ⚠️ 警告:此包不再接收更新
@visx/shape 是官方推荐的现代版本。
@vx 相同的 API 设计理念。// @visx/shape: 当前标准写法
import { Arc } from '@visx/shape';
// ✅ 推荐:稳定且持续更新
@visx/shape 将 D3 的逻辑封装为 React 组件。
// @visx/shape: 声明式组件
import { Pie } from '@visx/shape';
<Pie
data={data}
pieValue={(d) => d.value}
outerRadius={100}
>
{(pie) => pie.arcs.map((arc) => (
<path key={arc.key} d={arc.path} fill={arc.data.color} />
))}
</Pie>
d3-shape 提供纯粹的函数式 API。
useMemo 或 useEffect。// d3-shape: 命令式生成器
import { pie, arc } from 'd3-shape';
const pieGenerator = pie().value(d => d.value);
const arcGenerator = arc().innerRadius(0).outerRadius(100);
const arcs = pieGenerator(data);
// 手动映射到 JSX
{arcs.map(d => <path d={arcGenerator(d)} />)}
@visx/shape 和 d3-shape 专注于通用数据形状。
// @visx/shape: 通用折线图
import { Line } from '@visx/shape';
<Line
from={{ x: 0, y: 0 }}
to={{ x: 100, y: 50 }}
stroke="#fff"
/>
react-simple-maps 专注于地理空间数据。
// react-simple-maps: 地图组件
import { ComposableMap, Geographies, Geography } from 'react-simple-maps';
<ComposableMap>
<Geographies geography={geoJson}>
{({ geographies }) => geographies.map(geo => (
<Geography key={geo.rsmKey} geography={geo} />
))}
</Geographies>
</ComposableMap>
@visx/shape 依赖 React 的渲染周期。
// @visx/shape: 自动响应状态变化
function Chart({ data }) {
// data 更新时,Pie 组件自动重绘
return <Pie data={data} ... />;
}
d3-shape 需要手动触发更新。
// d3-shape: 手动计算路径
const pathData = useMemo(() => {
return lineGenerator(data);
}, [data]);
return <path d={pathData} />;
尽管用法不同,这些库在底层有着紧密的联系。
@visx/shape 和 react-simple-maps 底层都调用了 d3-shape 或 d3-geo。// 所有库最终都生成标准的 SVG path 数据
// d="M0,0 L10,10 A20,20 0,0,1 0,0"
// 均支持标准 SVG 属性
<path fill="blue" stroke="black" strokeWidth={2} />
// 混合使用示例:用 d3 计算,用 React 渲染
const path = d3Line(data);
return <path d={path} />;
| 特性 | @visx/shape | @vx/shape | d3-shape | react-simple-maps |
|---|---|---|---|---|
| 状态 | ✅ 活跃维护 | ❌ 已废弃 | ✅ 活跃维护 | ⚠️ 维护放缓 |
| 框架 | React 组件 | React 组件 | 纯 JS 函数 | React 组件 |
| 学习曲线 | 中等 | 中等 | 陡峭 | 低(针对地图) |
| 适用场景 | 通用图表 | 无(已迁移) | 高度定制/非 React | 地理地图 |
| ** declarative** | ✅ 是 | ✅ 是 | ❌ 否 | ✅ 是 |
@visx/shape 是现代 React 可视化项目的标准选择 🏆。它在 D3 的强大功能和 React 的开发体验之间取得了最佳平衡。除非你有特殊理由,否则应始终首选此包。
d3-shape 是底层基石 🧱。当你需要构建自己的可视化库,或者在 React 之外(如 Node.js 生成图表)工作时,它是唯一选择。在 React 中直接使用它通常意味着更多的样板代码。
react-simple-maps 是特定领域的利器 🗺️。如果项目核心是地图,它能极大缩短开发时间。但如果是混合了大量普通图表的仪表盘,使用 @visx 全家桶(包括 @visx/geo)可能能保持技术栈的统一性。
最终结论:废弃 @vx,首选 @visx 处理通用图表,仅在需要快速落地地图功能时考虑 react-simple-maps,而在需要极致控制或框架无关时使用 d3-shape。
选择 @visx/shape 如果你正在构建现代的 React 应用,希望使用声明式组件来绘制图表(如饼图、折线图),同时保留 D3 的强大功能。它是 @vx/shape 的官方继任者,拥有更好的维护和 TypeScript 支持,适合大多数需要定制化图表的场景。
切勿在新技术栈中选择 @vx/shape。该包已正式废弃,团队已将所有功能迁移至 @visx 命名空间。继续使用它将导致无法获得安全更新和新特性,且可能在未来构建中引发兼容性问题。
选择 d3-shape 如果你需要最大程度的控制权,或者在不使用 React 的环境中工作。它适合需要高性能、复杂动画或非标准渲染逻辑的场景。在 React 中使用它需要手动管理 DOM 和生命周期,样板代码较多。
选择 react-simple-maps 如果你的核心需求是交互式地理地图(如 choropleth 地图),而不是通用图表。它简化了 GeoJSON 处理和 D3 地理投影的复杂性。但如果是通用图表混合地图,考虑 @visx/geo 可能更统一。