使用指南布局
D3 力导向布局
D3 的力模拟根据节点间的作用力计算位置。
概述
D3 的力模拟根据节点间的作用力计算位置。
使用场景
适合需要调整斥力、边长或收敛速度的关系图。
基本用法
布局类型通过 layout.type 指定。
const graph = new Graph({
container,
data,
layout: { type: 'd3-force' },
});配置项
| 参数 | 描述 | 类型 | 默认值 |
|---|---|---|---|
linkDistance | 相连节点之间的目标距离。 | number 或函数 | max(200, √节点数 × 80) |
nodeStrength | 节点间的作用力。负值表示斥力。 | number 或函数 | -30 |
alphaDecay | 每步降低模拟热度的速率。 | number | 0.1 |
preventOverlap | 是否启用节点碰撞检测。 | boolean | false |
代码示例
边长目标设为 100，节点间用负的 nodeStrength 产生斥力。
const layout = { type: 'd3-force', linkDistance: 100, nodeStrength: -120, preventOverlap: true, nodeSize: 24 };import { Graph, register, type GraphOptions, type LayoutConfig } from '@antv/g6-lite';
type ExampleOptions = Pick<GraphOptions, 'data' | 'node' | 'edge'>;
function network(type: string): ExampleOptions {
const links = [
[0, 1], [0, 2], [0, 3], [1, 2], [1, 4], [1, 5],
[2, 5], [2, 6], [3, 7], [3, 8], [3, 9],
[7, 8], [8, 9], [4, 10], [4, 11], [10, 11],
];
return {
data: {
nodes: Array.from({ length: 12 }, (_, index) => ({ id: String(index) })),
edges: links.map(([source, target]) => ({ source: String(source), target: String(target) })),
},
node: {
style: {
size: 24,
label: (node) => node.id,
labelColor: '#fff',
labelPlacement: 'center',
fill: (node) => type === 'radial' && node.id === '0' ? '#6d28d9' : '#1677ff',
},
},
edge: { style: { lineWidth: 2 } },
};
}
async function render(container: HTMLElement, layout: LayoutConfig, options: ExampleOptions) {
const graph = new Graph({
container,
...options,
layout,
behaviors: ['drag-canvas', 'zoom-canvas'],
autoFit: { padding: 36, maxZoom: 1 },
});
try {
await graph.render();
return graph;
} catch (error) {
graph.destroy();
throw error;
}
}
export function run(container: HTMLElement) {
const layout: LayoutConfig = { type: 'd3-force', linkDistance: 100, nodeStrength: -120, preventOverlap: true, nodeSize: 24 };
return render(container, layout, network(layout.type));
}