可视化官方
Skill 文件
Skill
references
SKILL.md
SKILL.md
| name | antv-g6-graph |
|---|---|
| title | AntV G6 图可视化 |
| description | G6 v5 图可视化代码生成技能,支持网络图、树形图、流程图等多种图类型的初始化、布局、交互和插件配置 |
G6 v5 图可视化代码生成技能
核心约束(必须遵守)
初始化规范
container参数必填,传入 DOM 元素 ID 字符串或 DOM 元素对象- 使用
new Graph({...})构造函数,不得使用new G6.Graph()(v4 写法) - 所有配置在构造函数中一次性完成,不得事后多次调用配置方法覆盖
graph.render()返回 Promise,异步渲染;若需等待完成请await graph.render()
数据结构规范
- 数据格式:
{ nodes: [...], edges: [...], combos?: [...] } - 每个节点必须有唯一
id(字符串);业务数据放在data字段 - 边必须有
source和target,值为节点id - 禁止使用 v4 的
graph.data()方法传数据
节点/边样式规范
- 样式通过
node.style/edge.style配置,支持静态值和回调函数 - 回调函数签名:
(datum: NodeData | EdgeData) => value - 标签文本通过
style.labelText设置(不是label或labelCfg) - 节点大小通过
style.size设置(单个数值或 [width, height] 数组)
布局规范
layout配置放在 Graph 选项中:{ type: 'force', ... }force布局不支持preventOverlap/nodeSize(G6 v4 参数,v5 静默忽略);防重叠请改用d3-force+collide- 树形布局(mindmap, compact-box, dendrogram, indented)需要树形数据或
treeToGraphData()转换 - 力导向布局异步运行,
graph.render()后会持续迭代 nodeStrength必须为非负数(≥ 0),负值会导致布局计算异常或节点行为不可预测
交互行为规范
behaviors为字符串数组或配置对象数组- 常用行为字符串简写:
'drag-canvas','zoom-canvas','drag-element','click-select' - G6 v5 移除了 Mode(模式)概念,所有 behavior 直接在数组中配置
- 复杂配置使用对象形式:
{ type: 'click-select', multiple: true }
插件规范
plugins为数组,与behaviors类似- 简写:
'minimap','grid-line','tooltip' - 复杂配置:
{ type: 'tooltip', getContent: (e, items) => '...' }
禁止的错误模式
❌ 使用 v4 API
❌ 错误的节点 data 结构
❌ 错误的标签配置
❌ behaviors 使用 Mode 概念
❌ 自定义节点 render() 中读取 attributes.data → 白屏
❌ 使用 extend 注册自定义节点
❌ 缺少 container
> 常见变体错误:container: container(把字符串 ID 当变量名使用,变量未定义 → ReferenceError → 白屏)
❌ autoFit: 'view' 配合异步力导向布局导致白屏
> 同步布局(dagre、grid、circular 等)不受此影响,可以直接用 autoFit: 'view'。
基础结构模板
图类型选择指南
内置节点类型
内置边类型
内置布局算法
内置交互行为
内置插件
元素状态(States)
G6 v5 内置 5 种状态:selected、active、highlight、inactive、disabled
主题系统
数据操作 API
常见使用模式
数据驱动样式(推荐)
调色板(Palette)映射
连续数值映射节点大小
平行边处理
数据操作 API 速查
事件监听速查
Reference 文档索引
核心
g6-core-graph-init[blocked]:Graph 初始化完整配置g6-core-data-structure[blocked]:数据结构规范g6-core-graph-api[blocked]:Graph 实例 API(增删改查、视口、状态)g6-core-events[blocked]:事件系统(元素事件、画布事件、生命周期)g6-core-custom-element[blocked]:自定义节点/边(register + BaseNode/BaseEdge)g6-core-transforms-animation[blocked]:数据变换(map-node-size)与动画配置
节点类型
g6-node-circle[blocked]:圆形(通用)g6-node-rect[blocked]:矩形(流程图)g6-node-image[blocked]:图片节点g6-node-diamond-ellipse-hexagon[blocked]:菱形/椭圆/六边形g6-node-star-triangle-donut[blocked]:五角星/三角形/环形进度g6-node-html[blocked]:HTML 富文本节点g6-node-react[blocked]:React/Vue 自定义节点(@antv/g6-extension-react)
Combo
g6-combo-overview[blocked]:Combo 分组(circle/rect,折叠展开)
边类型
g6-edge-line[blocked]:直线边g6-edge-cubic[blocked]:三次贝塞尔曲线边g6-edge-cubic-directional[blocked]:有向三次曲线(cubic-horizontal 水平 / cubic-vertical 垂直)g6-edge-polyline[blocked]:折线边g6-edge-quadratic-loop[blocked]:二次曲线与自环边
布局
g6-layout-force[blocked]:力导向(force/d3-force)g6-layout-dagre[blocked]:层次/流程图(dagre)g6-layout-circular[blocked]:环形g6-layout-grid[blocked]:网格g6-layout-mindmap[blocked]:思维导图g6-layout-advanced[blocked]:同心圆/辐射/mds/fruchtermang6-layout-combo-fishbone[blocked]:复合布局(combo-combined)+ 鱼骨布局(fishbone)
数据变换
g6-core-transforms-animation[blocked]:map-node-size 与动画配置g6-transform-parallel-edges-radial[blocked]:平行边处理(process-parallel-edges)+ 径向标签(place-radial-labels)
交互行为
g6-behavior-click-select[blocked]:点击选中g6-behavior-drag-element[blocked]:拖拽节点g6-behavior-canvas-nav[blocked]:画布拖拽+缩放g6-behavior-hover-activate[blocked]:悬停激活g6-behavior-lasso-collapse[blocked]:套索选择 + 折叠展开g6-behavior-create-edge-focus[blocked]:创建边 + 聚焦元素g6-behavior-advanced[blocked]:fix-element-size / auto-adapt-label / drag-element-force
插件
g6-plugin-tooltip[blocked]:悬停提示框g6-plugin-minimap[blocked]:缩略图g6-plugin-contextmenu-toolbar[blocked]:右键菜单 + 工具栏g6-plugin-history-legend[blocked]:撤销重做 + 图例g6-plugin-fisheye-hull-watermark[blocked]:鱼眼放大 + 轮廓包围 + 水印g6-plugin-timebar-gridline[blocked]:时间轴 + 网格线g6-plugin-background-snapline[blocked]:画布背景(background)+ 对齐线(snapline)g6-plugin-edge-bundling-bubble[blocked]:边绑定(edge-bundling)+ 气泡集(bubble-sets)g6-plugin-fullscreen-title[blocked]:全屏(fullscreen)+ 图标题(title)
状态与主题
g6-state-overview[blocked]:元素状态系统g6-theme-overview[blocked]:主题系统
场景模板
g6-pattern-network-graph[blocked]:网络关系图g6-pattern-tree-graph[blocked]:树形图/组织架构g6-pattern-flow-chart[blocked]:流程图
Ln 1, Col 1MarkdownSpaces: 2
No errors