使用指南交互
拖动边端点
拖动已有边的端点,松开时通过事件获取重连目标。
拖动已有边的端点,松开时通过事件获取重连目标。
配置方式
从靠近端点的位置开始拖动。松开后,edge:dragend 返回重连建议,确认后调用 updateEdgeData() 写回。
示例
graph.on('edge:dragend', ({ edgeId, source, target, reconnected }) => {
if (reconnected && edgeId) {
graph.updateEdgeData([{ id: edgeId, source, target }]);
}
ui.setStatus(`dragend reconnected=${reconnected}\n${edgeId ?? '-'}: ${source} → ${target}`);
});import { Graph } from '@antv/g6-lite';
import GUI from 'lil-gui';
export async function run(container: string | HTMLElement) {
const graph = new Graph({
autoFit: { padding: 48, maxZoom: 1 },
container,
data: {
nodes: [
{ id: 'a', x: 120, y: 160, data: { label: 'A' } },
{ id: 'b', x: 340, y: 80, data: { label: 'B' } },
{ id: 'c', x: 340, y: 240, data: { label: 'C' } },
{ id: 'd', x: 560, y: 160, data: { label: 'D' } },
],
edges: [
{ id: 'editable-edge', source: 'a', target: 'b' },
{ id: 'reference-edge', source: 'c', target: 'd' },
],
},
node: { style: { size: 38, label: (node) => String(node.data?.label ?? node.id), labelPlacement: 'center', labelColor: '#fff' } },
edge: { style: { lineWidth: 4, hitAreaWidth: 16, endArrow: true } },
behaviors: ['zoom-canvas', 'drag-canvas', 'drag-edge'],
});
const ui = createDemoPanel(container);
graph.on('edge:dragstart', (payload: { edgeId?: string; dragEnd: string }) => {
ui.setStatus(`dragstart ${payload.edgeId ?? '-'} (${payload.dragEnd})`);
});
// #region reconnect
graph.on('edge:dragend', ({ edgeId, source, target, reconnected }) => {
if (reconnected && edgeId) {
graph.updateEdgeData([{ id: edgeId, source, target }]);
}
ui.setStatus(`dragend reconnected=${reconnected}\n${edgeId ?? '-'}: ${source} → ${target}`);
});
// #endregion reconnect
const destroy = graph.destroy.bind(graph);
graph.destroy = () => {
ui.destroy();
destroy();
};
try {
await graph.render();
return graph;
} catch (error) {
graph.destroy();
throw error;
}
}
export function createDemoPanel(container: string | HTMLElement, description = '') {
const host = typeof container === 'string' ? document.querySelector<HTMLElement>(container)! : container;
if (getComputedStyle(host).position === 'static') host.style.position = 'relative';
let gui: GUI | undefined;
const getGui = () => {
if (!gui) {
gui = new GUI({ container: host, width: 160 });
gui.domElement.classList.add('g6lite-demo-controls');
gui.domElement.dataset.captureIgnore = '';
Object.assign(gui.domElement.style, {
position: 'absolute',
top: '10px',
right: '10px',
zIndex: '30',
maxWidth: 'calc(100% - 20px)',
maxHeight: 'calc(100% - 20px)',
});
}
return gui;
};
let status: HTMLDivElement | undefined;
const setStatus = (message: string) => {
if (!status) {
status = document.createElement('div');
status.setAttribute('role', 'status');
status.dataset.role = 'status';
status.dataset.captureIgnore = '';
status.style.cssText =
'position:absolute;left:12px;bottom:10px;z-index:20;max-width:min(28rem,calc(100% - 24px));color:#64748b;font:12px/1.45 system-ui,sans-serif;pointer-events:none;white-space:pre-wrap;';
host.append(status);
}
status.textContent = message;
};
if (description) setStatus(description);
return {
get gui() {
return getGui();
},
addAction(label: string, action: () => void, folder = getGui()) {
return folder.add({ [label]: action }, label);
},
addChoice<T extends string>(
label: string,
choices: readonly T[] | Record<string, T>,
value: T,
onChange: (value: T) => void,
) {
const options = Array.isArray(choices) ? [...choices] : choices;
return getGui().add({ value }, 'value', options).name(label).onChange(onChange);
},
setStatus,
destroy() {
gui?.destroy();
status?.remove();
},
};
}