EdgeFilterLens 边过滤镜
上一篇
EdgeBundling 边绑定
下一篇
Fisheye 鱼眼放大镜
Loading...
边过滤镜插件可以将关注的边保留在过滤镜范围内，其他边将在该范围内不显示。这是一个重要的可视化探索工具，可以帮助用户聚焦于特定区域的边关系。
const graph = new Graph({plugins: [{type: 'edge-filter-lens',trigger: 'pointermove', // 跟随鼠标移动r: 60, // 设置透镜半径nodeType: 'both', // 边的显示条件},],});
createGraph({data: {nodes: [// 上部疏散区域{ id: 'Myriel', style: { x: 207, y: 78, label: 'Myriel' } },{ id: 'Napoleon', style: { x: 127, y: 62, label: 'Napoleon' } },{ id: 'CountessdeLo', style: { x: 171, y: 47, label: 'CountessdeLo' } },{ id: 'Geborand', style: { x: 106, y: 81, label: 'Geborand' } },{ id: 'Champtercier', style: { x: 247, y: 58, label: 'Champtercier' } },{ id: 'Cravatte', style: { x: 152, y: 50, label: 'Cravatte' } },// 中上部区域{ id: 'Mlle.Baptistine', style: { x: 205, y: 141, label: 'Mlle.Baptistine' } },{ id: 'Mme.Magloire', style: { x: 275, y: 120, label: 'Mme.Magloire' } },{ id: 'Labarre', style: { x: 246, y: 183, label: 'Labarre' } },{ id: 'Valjean', style: { x: 342, y: 221, label: 'Valjean' } },{ id: 'Marguerite', style: { x: 285, y: 171, label: 'Marguerite' } },// 中部密集区域{ id: 'Tholomyes', style: { x: 379, y: 158, label: 'Tholomyes' } },{ id: 'Listolier', style: { x: 288, y: 80, label: 'Listolier' } },{ id: 'Fameuil', style: { x: 349, y: 89, label: 'Fameuil' } },{ id: 'Blacheville', style: { x: 381, y: 95, label: 'Blacheville' } },{ id: 'Favourite', style: { x: 264, y: 153, label: 'Favourite' } },{ id: 'Dahlia', style: { x: 323, y: 170, label: 'Dahlia' } },{ id: 'Zephine', style: { x: 306, y: 114, label: 'Zephine' } },{ id: 'Fantine', style: { x: 357, y: 187, label: 'Fantine' } },// 右侧区域{ id: 'Bamatabois', style: { x: 411, y: 156, label: 'Bamatabois' } },{ id: 'Perpetue', style: { x: 454, y: 195, label: 'Perpetue' } },{ id: 'Simplice', style: { x: 406, y: 227, label: 'Simplice' } },// 下部区域{ id: 'Cosette', style: { x: 343, y: 248, label: 'Cosette' } },{ id: 'Javert', style: { x: 388, y: 263, label: 'Javert' } },{ id: 'Fauchelevent', style: { x: 397, y: 276, label: 'Fauchelevent' } },{ id: 'Thenardier', style: { x: 317, y: 300, label: 'Thenardier' } },{ id: 'Eponine', style: { x: 268, y: 365, label: 'Eponine' } },{ id: 'Anzelma', style: { x: 234, y: 303, label: 'Anzelma' } },{ id: 'Woman2', style: { x: 304, y: 254, label: 'Woman2' } },// 最右侧独立节点{ id: 'Gribier', style: { x: 457, y: 160, label: 'Gribier' } },{ id: 'Jondrette', style: { x: 510, y: 327, label: 'Jondrette' } },],edges: [// 上部连接{ id: 'e1', source: 'Myriel', target: 'CountessdeLo' },{ id: 'e2', source: 'Napoleon', target: 'Myriel' },{ id: 'e3', source: 'Geborand', target: 'Napoleon' },{ id: 'e4', source: 'Champtercier', target: 'Myriel' },{ id: 'e5', source: 'Cravatte', target: 'CountessdeLo' },// 中上部连接{ id: 'e6', source: 'Mlle.Baptistine', target: 'Mme.Magloire' },{ id: 'e7', source: 'Labarre', target: 'Valjean' },{ id: 'e8', source: 'Valjean', target: 'Marguerite' },{ id: 'e9', source: 'Marguerite', target: 'Mme.Magloire' },// 中部密集连接{ id: 'e10', source: 'Tholomyes', target: 'Listolier' },{ id: 'e11', source: 'Listolier', target: 'Fameuil' },{ id: 'e12', source: 'Fameuil', target: 'Blacheville' },{ id: 'e13', source: 'Blacheville', target: 'Favourite' },{ id: 'e14', source: 'Favourite', target: 'Dahlia' },{ id: 'e15', source: 'Dahlia', target: 'Zephine' },{ id: 'e16', source: 'Zephine', target: 'Fantine' },{ id: 'e17', source: 'Tholomyes', target: 'Fantine' },{ id: 'e18', source: 'Valjean', target: 'Fantine' },// 右侧连接{ id: 'e19', source: 'Bamatabois', target: 'Perpetue' },{ id: 'e20', source: 'Perpetue', target: 'Simplice' },{ id: 'e21', source: 'Bamatabois', target: 'Gribier' },// 下部连接{ id: 'e22', source: 'Valjean', target: 'Cosette' },{ id: 'e23', source: 'Cosette', target: 'Javert' },{ id: 'e24', source: 'Javert', target: 'Fauchelevent' },{ id: 'e25', source: 'Fauchelevent', target: 'Thenardier' },{ id: 'e26', source: 'Thenardier', target: 'Eponine' },{ id: 'e27', source: 'Eponine', target: 'Anzelma' },{ id: 'e28', source: 'Woman2', target: 'Cosette' },// 跨区域连接{ id: 'e29', source: 'Fantine', target: 'Bamatabois' },{ id: 'e30', source: 'Javert', target: 'Bamatabois' },{ id: 'e31', source: 'Simplice', target: 'Jondrette' },{ id: 'e32', source: 'Thenardier', target: 'Jondrette' },{ id: 'e33', source: 'Favourite', target: 'Valjean' },{ id: 'e34', source: 'Tholomyes', target: 'Cosette' },],},node: {style: {label: true,size: 16,},palette: {field: (datum) => Math.floor(datum.style?.y / 60),},},edge: {style: {label: true,labelText: (d) => d.data.value?.toString(),stroke: '#ccc',endArrow: true,endArrowType: 'triangle',},},plugins: [{type: 'edge-filter-lens',key: 'edge-filter-lens',r: 80,trigger: 'pointermove',},],},{ width: 600, height: 400 },(gui, graph) => {const TRIGGER_TYPES = ['pointermove', 'click', 'drag'];const NODE_TYPES = ['both', 'source', 'target', 'either'];const options = {type: 'edge-filter-lens',r: 80, // 透镜半径trigger: 'pointermove', // 触发方式nodeType: 'both', // 边显示条件minR: 50, // 最小半径maxR: 150, // 最大半径scaleRBy: 'wheel', // 缩放方式style: {fill: '#f0f5ff',fillOpacity: 0.4,stroke: '#1d39c4',strokeOpacity: 0.8,lineWidth: 1.5,},nodeStyle: {size: 35,fill: '#d6e4ff',stroke: '#2f54eb',lineWidth: 2,labelFontSize: 14,labelFontWeight: 'bold',labelFill: '#1d39c4',},edgeStyle: {stroke: '#1d39c4',lineWidth: 2,strokeOpacity: 0.8,},};const optionFolder = gui.addFolder('Edge Filter Lens Options');optionFolder.add(options, 'type').disable(true);optionFolder.add(options, 'r', 50, 150, 5);optionFolder.add(options, 'trigger', TRIGGER_TYPES);optionFolder.add(options, 'nodeType', NODE_TYPES);optionFolder.add(options, 'minR', 20, 100, 5);optionFolder.add(options, 'maxR', 100, 200, 5);optionFolder.onChange(({ property, value }) => {if (property.includes('.')) {const [group, prop] = property.split('.');graph.updatePlugin({key: 'edge-filter-lens',[group]: {...options[group],[prop]: value,},});} else {graph.updatePlugin({key: 'edge-filter-lens',[property]: value,});}graph.render();});},);
| 属性 | 描述 | 类型 | 默认值 | 必选 |
|---|---|---|---|---|
| type | 插件类型 | string | edge-filter-lens | ✓ |
| trigger | 移动透镜的方式 | pointermove | click | drag | pointermove | |
| r | 透镜的半径 | number | 60 | |
| maxR | 透镜的最大半径 | number | 画布宽高最小值的一半 | |
| minR | 透镜的最小半径 | number | 0 | |
| scaleRBy | 缩放透镜半径的方式 | wheel | - | |
| nodeType | 边显示的条件 | both | source | target | either | both | |
| filter | 过滤出始终不在透镜中显示的元素 | (id: string, elementType: 'node' | 'edge' | 'combo') => boolean | () => true | |
| style | 透镜的样式 | CircleStyleProps | {fill: '#fff', fillOpacity: 1, lineWidth: 1, stroke: '#000', strokeOpacity: 0.8, zIndex: -Infinity } | |
| nodeStyle | 在透镜中节点的样式 | NodeStyle | ((datum: NodeData) => NodeStyle) | { label: false } | |
| edgeStyle | 在透镜中边的样式 | EdgeStyle | ((datum: EdgeData) => EdgeStyle) | { label: true } | |
| preventDefault | 是否阻止默认事件 | boolean | true |
圆形透镜的样式属性。
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| fill | 填充颜色 | string | Pattern | null | - |
| stroke | 描边颜色 | string | Pattern | null | - |
| opacity | 整体透明度 | number | string | - |
| fillOpacity | 填充透明度 | number | string | - |
| strokeOpacity | 描边透明度 | number | string | - |
| lineWidth | 线宽度 | number | string | - |
| lineCap | 线段端点样式 | butt | round | square | - |
| lineJoin | 线段连接处样式 | miter | round | bevel | - |
| shadowColor | 阴影颜色 | string | - |
| shadowBlur | 阴影模糊程度 | number | - |
| shadowOffsetX | 阴影 X 方向偏移 | number | - |
| shadowOffsetY | 阴影 Y 方向偏移 | number | - |
完整样式属性参考 元素 -节点 - 内置节点 - 通用样式属性 - style
trigger 属性用于控制透镜的移动方式，支持以下三种配置：
pointermove：透镜始终跟随鼠标移动click：点击画布时移动透镜到点击位置drag：通过拖拽方式移动透镜const graph = new Graph({plugins: [{type: 'edge-filter-lens',trigger: 'pointermove', // 跟随鼠标移动// trigger: 'click', // 点击移动// trigger: 'drag', // 拖拽移动},],});
nodeType 属性用于控制边的显示条件：
both：只有起始节点和目标节点都在透镜中时，边才会显示source：只有起始节点在透镜中时，边才会显示target：只有目标节点在透镜中时，边才会显示either：只要起始节点或目标节点有一个在透镜中时，边就会显示const graph = new Graph({plugins: [{type: 'edge-filter-lens',nodeType: 'both', // 起始和目标节点都在透镜中时显示边// nodeType: 'source', // 起始节点在透镜中时显示边// nodeType: 'target', // 目标节点在透镜中时显示边// nodeType: 'either', // 起始或目标节点在透镜中时显示边},],});
通过 scaleRBy 可以控制透镜半径的调整方式：
const graph = new Graph({plugins: [{type: 'edge-filter-lens',// 通过滚轮调整半径scaleRBy: 'wheel',// 设置半径范围minR: 50,maxR: 200,},],});
最简单的配置方式：
const graph = new Graph({plugins: ['edge-filter-lens'],});
效果如下：
createGraph({data: {nodes: [// 上部疏散区域{ id: 'node1', style: { x: 150, y: 60, label: 'Node 1' } },{ id: 'node2', style: { x: 100, y: 40, label: 'Node 2' } },{ id: 'node3', style: { x: 200, y: 35, label: 'Node 3' } },{ id: 'node4', style: { x: 150, y: 30, label: 'Node 4' } },// 中部区域{ id: 'node5', style: { x: 220, y: 140, label: 'Node 5' } },{ id: 'node6', style: { x: 280, y: 160, label: 'Node 6' } },{ id: 'node7', style: { x: 220, y: 120, label: 'Node 7' } },{ id: 'node8', style: { x: 260, y: 100, label: 'Node 8' } },{ id: 'node9', style: { x: 240, y: 130, label: 'Node 9' } },{ id: 'node10', style: { x: 300, y: 110, label: 'Node 10' } },// 下部区域{ id: 'node11', style: { x: 240, y: 200, label: 'Node 11' } },{ id: 'node12', style: { x: 280, y: 220, label: 'Node 12' } },{ id: 'node13', style: { x: 300, y: 190, label: 'Node 13' } },{ id: 'node14', style: { x: 320, y: 210, label: 'Node 14' } },],edges: [// 上部连接{ id: 'edge1', source: 'node1', target: 'node2' },{ id: 'edge2', source: 'node2', target: 'node3' },{ id: 'edge3', source: 'node3', target: 'node4' },// 中部连接{ id: 'edge4', source: 'node5', target: 'node6' },{ id: 'edge5', source: 'node6', target: 'node7' },{ id: 'edge6', source: 'node7', target: 'node8' },{ id: 'edge7', source: 'node8', target: 'node9' },{ id: 'edge8', source: 'node9', target: 'node10' },// 下部连接{ id: 'edge9', source: 'node11', target: 'node12' },{ id: 'edge10', source: 'node12', target: 'node13' },{ id: 'edge11', source: 'node13', target: 'node14' },// 跨区域连接{ id: 'edge12', source: 'node4', target: 'node8' },{ id: 'edge13', source: 'node7', target: 'node11' },{ id: 'edge14', source: 'node10', target: 'node13' },],},node: {style: {size: 20,},},plugins: ['edge-filter-lens'],},{ width: 400, height: 300 },);
可以自定义透镜的外观和行为：
const graph = new Graph({plugins: [{type: 'edge-filter-lens',r: 80,style: {fill: '#f0f5ff', // 透镜区域的填充颜色fillOpacity: 0.6, // 填充区域的透明度stroke: '#7e3feb', // 透镜边框改为紫色strokeOpacity: 0.8, // 边框的透明度lineWidth: 1.5, // 边框的线宽},nodeStyle: {size: 24, // 放大节点fill: '#7e3feb', // 紫色填充stroke: '#5719c9', // 深紫色描边lineWidth: 1, // 细边框label: true, // 显示标签labelFill: '#ffffff', // 白色文字labelFontSize: 14, // 放大文字labelFontWeight: 'bold', // 文字加粗},edgeStyle: {stroke: '#8b9baf', // 灰色边lineWidth: 2, // 加粗边线label: true, // 显示标签labelFill: '#5719c9', // 深紫色文字opacity: 0.8, // 适当的透明度},},],});
效果如下：
createGraph({data: {nodes: [// 上部疏散区域{ id: 'node1', style: { x: 150, y: 60, label: 'Node 1' } },{ id: 'node2', style: { x: 100, y: 40, label: 'Node 2' } },{ id: 'node3', style: { x: 200, y: 35, label: 'Node 3' } },{ id: 'node4', style: { x: 150, y: 30, label: 'Node 4' } },// 中部区域{ id: 'node5', style: { x: 220, y: 140, label: 'Node 5' } },{ id: 'node6', style: { x: 280, y: 160, label: 'Node 6' } },{ id: 'node7', style: { x: 220, y: 120, label: 'Node 7' } },{ id: 'node8', style: { x: 260, y: 100, label: 'Node 8' } },{ id: 'node9', style: { x: 240, y: 130, label: 'Node 9' } },{ id: 'node10', style: { x: 300, y: 110, label: 'Node 10' } },// 下部区域{ id: 'node11', style: { x: 240, y: 200, label: 'Node 11' } },{ id: 'node12', style: { x: 280, y: 220, label: 'Node 12' } },{ id: 'node13', style: { x: 300, y: 190, label: 'Node 13' } },{ id: 'node14', style: { x: 320, y: 210, label: 'Node 14' } },],edges: [// 上部连接{ id: 'edge1', source: 'node1', target: 'node2' },{ id: 'edge2', source: 'node2', target: 'node3' },{ id: 'edge3', source: 'node3', target: 'node4' },// 中部连接{ id: 'edge4', source: 'node5', target: 'node6' },{ id: 'edge5', source: 'node6', target: 'node7' },{ id: 'edge6', source: 'node7', target: 'node8' },{ id: 'edge7', source: 'node8', target: 'node9' },{ id: 'edge8', source: 'node9', target: 'node10' },// 下部连接{ id: 'edge9', source: 'node11', target: 'node12' },{ id: 'edge10', source: 'node12', target: 'node13' },{ id: 'edge11', source: 'node13', target: 'node14' },// 跨区域连接{ id: 'edge12', source: 'node4', target: 'node8' },{ id: 'edge13', source: 'node7', target: 'node11' },{ id: 'edge14', source: 'node10', target: 'node13' },],},node: {style: {size: 20,},},edge: {style: {stroke: '#91d5ff',lineWidth: 1,},},plugins: [{type: 'edge-filter-lens',r: 80,style: {fill: '#f0f5ff', // 透镜区域的填充颜色fillOpacity: 0.6, // 填充区域的透明度stroke: '#7e3feb', // 透镜边框改为紫色strokeOpacity: 0.8, // 边框的透明度lineWidth: 1.5, // 边框的线宽},nodeStyle: {size: 24, // 放大节点fill: '#7e3feb', // 紫色填充stroke: '#5719c9', // 深紫色描边lineWidth: 1, // 细边框label: true, // 显示标签labelFill: '#ffffff', // 白色文字labelFontSize: 14, // 放大文字labelFontWeight: 'bold', // 文字加粗},edgeStyle: {stroke: '#8b9baf', // 灰色边lineWidth: 2, // 加粗边线label: true, // 显示标签labelFill: '#5719c9', // 深紫色文字opacity: 0.8, // 适当的透明度},},],},{ width: 400, height: 300 },);