G6

BubbleSets 最初由 Christopher Collins 在 2009 年的论文 "Bubble Sets: Revealing Set Relations with Isocontours over Existing Visualizations" 中提出。

实现原理是通过创建一种类似于气泡的形状来表示集合。每个集合都被表示为一个独特的 "气泡"，集合中的元素被包含在这个气泡内部。如果两个集合有交集，那么这两个气泡会有重叠的部分，这个重叠的部分就表示这两个集合的交集。

createGraph(
  {
    autoFit: 'center',
    data: {
      nodes: [
        {
          id: 'node-0',
          data: { cluster: 'a' },
          style: { x: 555, y: 151 },
        },
        {
          id: 'node-1',
          data: { cluster: 'a' },
          style: { x: 532, y: 323 },
        },
        {
          id: 'node-2',
          data: { cluster: 'a' },
          style: { x: 473, y: 227 },
        },
        {
          id: 'node-3',
          data: { cluster: 'a' },
          style: { x: 349, y: 212 },
        },
        {
          id: 'node-4',
          data: { cluster: 'b' },
          style: { x: 234, y: 201 },
        },
        {
          id: 'node-5',
          data: { cluster: 'b' },
          style: { x: 338, y: 333 },
        },
        {
          id: 'node-6',
          data: { cluster: 'b' },
          style: { x: 365, y: 91 },
        },
      ],
      edges: [
        {
          id: 'edge-0',
          source: 'node-0',
          target: 'node-2',
        },
        {
          id: 'edge-1',
          source: 'node-1',
          target: 'node-2',
        },
        {
          id: 'edge-2',
          source: 'node-2',
          target: 'node-3',
        },
        {
          id: 'edge-3',
          source: 'node-3',
          target: 'node-4',
        },
        {
          id: 'edge-4',
          source: 'node-3',
          target: 'node-5',
        },
        {
          id: 'edge-5',
          source: 'node-3',
          target: 'node-6',
        },
      ],
    },
    node: {
      style: { labelText: (d) => d.id },
      palette: { field: 'cluster', color: ['#7e3feb', '#ffa940'] },
    },
    behaviors: ['drag-canvas', 'drag-element'],
    plugins: [
      'grid-line',
      {
        type: 'bubble-sets',
        key: 'bubble-sets',
        members: ['node-0', 'node-1', 'node-2', 'node-3'],
        labelText: 'bubblesets-a',
        fill: '#7e3feb',
        fillOpacity: 0.1,
        stroke: '#7e3feb',
        strokeOpacity: 1,
        labelFill: '#fff',
        labelPadding: 2,
        labelBackgroundFill: '#7e3feb',
        labelBackgroundRadius: 5,
      },
    ],
  },
  { width: 600, height: 450 },
  (gui, graph) => {
    const options = {
      type: 'bubble-sets',
      members: ['node-0', 'node-1', 'node-2', 'node-3'],
      avoidMembers: [],
      // style
      fill: '#7e3feb',
      fillOpacity: 0.1,
      stroke: '#7e3feb',
      strokeOpacity: 1,
      // label
      label: true,
      labelCloseToPath: true,
      labelAutoRotate: true,
      labelOffsetX: 0,
      labelOffsetY: 0,
      labelPlacement: 'bottom',
      // bubblesets
      maxRoutingIterations: 100,
      maxMarchingIterations: 20,
      pixelGroup: 4,
      edgeR0: 10,
      edgeR1: 20,
      nodeR0: 15,
      nodeR1: 50,
      morphBuffer: 10,
      threshold: 1,
      memberInfluenceFactor: 1,
      edgeInfluenceFactor: 1,
      nonMemberInfluenceFactor: -0.8,
      virtualEdges: true,
    };

    const optionFolder = gui.addFolder('Bubblesets Options');
    optionFolder.add(options, 'type').disable();
    optionFolder.addColor(options, 'fill');
    optionFolder.addColor(options, 'stroke');
    optionFolder.add(options, 'fillOpacity', 0, 1, 0.1);
    optionFolder.add(options, 'strokeOpacity', 0, 1, 0.1);
    optionFolder.add(options, 'label');
    optionFolder.add(options, 'labelCloseToPath');
    optionFolder.add(options, 'labelAutoRotate');
    optionFolder.add(options, 'labelOffsetX', 0, 20, 1);
    optionFolder.add(options, 'labelOffsetY', 0, 20, 1);
    optionFolder.add(options, 'labelPlacement', ['left', 'right', 'top', 'bottom', 'center']);
    optionFolder.add(options, 'maxRoutingIterations', 0, 200, 1);
    optionFolder.add(options, 'maxMarchingIterations', 0, 40, 1);
    optionFolder.add(options, 'pixelGroup', 0, 20, 1);
    optionFolder.add(options, 'edgeR0', 0, 50, 1);
    optionFolder.add(options, 'edgeR1', 0, 50, 1);
    optionFolder.add(options, 'nodeR0', 0, 50, 1);
    optionFolder.add(options, 'nodeR1', 0, 50, 1);
    optionFolder.add(options, 'morphBuffer', 0, 20, 1);
    optionFolder.add(options, 'threshold', -1, 1, 0.1);
    optionFolder.add(options, 'memberInfluenceFactor', -1, 1, 0.1);
    optionFolder.add(options, 'edgeInfluenceFactor', -1, 1, 0.1);
    optionFolder.add(options, 'nonMemberInfluenceFactor', -1, 1, 0.1);
    optionFolder.add(options, 'virtualEdges');

    optionFolder.onChange(({ property, value }) => {
      graph.updatePlugin({
        key: 'bubble-sets',
        [property]: value,
      });
      graph.render();
    });

    const apiConfig = {
      member: 'node-1',
      avoidMember: 'node-1',
    };
    const apiFolder = gui.addFolder('Bubblesets API');
    const instance = graph.getPluginInstance('bubble-sets');
    const nodeIds = graph.getData().nodes.map((node) => node.id);
    const edgeIds = graph.getData().edges.map((edge) => edge.id);
    apiFolder.add(apiConfig, 'member', [...nodeIds, ...edgeIds]);
    apiFolder.add({ addMember: () => instance.addMember(apiConfig.member) }, 'addMember').name('add member');
    apiFolder
      .add({ removeMember: () => instance.removeMember(apiConfig.member) }, 'removeMember')
      .name('remove member');
    apiFolder
      .add({ removeMember: () => alert('Members in Bubblesets: ' + instance.getMember()) }, 'removeMember')
      .name('get member');
    apiFolder.add(apiConfig, 'avoidMember', nodeIds);
    apiFolder
      .add({ addAvoidMember: () => instance.addAvoidMember(apiConfig.avoidMember) }, 'addAvoidMember')
      .name('add avoid member');
    apiFolder
      .add({ removeAvoidMember: () => instance.removeAvoidMember(apiConfig.avoidMember) }, 'removeAvoidMember')
      .name('remove avoid member');
    apiFolder
      .add({ removeMember: () => alert('Avoid members in Bubblesets: ' + instance.getAvoidMember()) }, 'removeMember')
      .name('get avoid member');
  },
);

参考示例：

用气泡集包裹节点集

配置项

Required type

bubble-sets | string

此插件已内置，你可以通过 type: 'bubble-sets' 来使用它。

label

boolean Default: true

是否显示标签

avoidMembers

string[]

需要避开的元素，在绘制轮廓时不会包含这些元素。目前支持设置节点

Required members

string[]

成员元素，包括节点和边

Label 样式

label{TextStyleProps}

形如 icon{TextStyleProps} 的表达式表示在 TextStyleProps 属性名前以小驼峰形式加上 icon 前缀

TextStyleProps 包含以下属性：

fill
fontSize
fontWeight
...

icon{TextStyleProps} 表示你需要使用以下属性名：

iconFill
iconFontSize
iconFontWeight
...

labelAutoRotate

boolean Default: true

标签是否跟随轮廓旋转，仅在 closeToPath 为 true 时生效

labelCloseToPath

boolean Default: true

标签是否贴合轮廓

labelMaxWidth

number

文本的最大宽度，超出会自动省略

labelOffsetX

number Default: 0

x 轴偏移量

labelOffsetY

number Default: 0

y 轴偏移量

labelPlacement

'left' | 'right' | 'top' | 'bottom' | 'center' Default: 'bottom'

标签位置

labelBackground

boolean

是否显示背景

labelPadding

number | number[] Default: 0

标签内边距

Label Background 样式

labelBackground{RectStyleProps}

形如 icon{TextStyleProps} 的表达式表示在 TextStyleProps 属性名前以小驼峰形式加上 icon 前缀

TextStyleProps 包含以下属性：

fill
fontSize
fontWeight
...

icon{TextStyleProps} 表示你需要使用以下属性名：

iconFill
iconFontSize
iconFontWeight
...

API

BubbleSets.addAvoidMember(avoidMembers)

添加需要避开的元素

addAvoidMember(avoidMembers: ID | ID[]): void;

参数	描述	类型	默认值	必选
avoidMembers	元素 ID	ID \| ID[]	-	✓

BubbleSets.addMember(members)

添加成员元素

addMember(members: ID | ID[]): void;

参数	描述	类型	默认值	必选
members	元素 ID	ID \| ID[]	-	✓

BubbleSets.getAvoidMember()

获取需要避开的元素

getAvoidMember(): string[];

返回值：

**类型：**string[]
**描述：**成员元素数组

BubbleSets.getMember()

获取成员元素

getMember(): string[];

返回值：

**类型：**string[]
**描述：**成员元素数组

BubbleSets.removeAvoidMember(avoidMembers)

移除需要避开的元素

removeAvoidMember(avoidMembers: ID | ID[]): void;

参数	描述	类型	默认值	必选
avoidMembers	元素 ID	ID \| ID[]	-	✓

BubbleSets.removeMember(members)

移除成员元素

removeMember(members: ID | ID[]): void;

参数	描述	类型	默认值	必选
members	元素 ID	ID \| ID[]	-	✓

BubbleSets.updateAvoidMember(avoidMembers)

更新需要避开的元素

updateAvoidMember(avoidMembers: ID | ID[]): void;

参数	描述	类型	默认值	必选
avoidMembers	元素 ID	ID \| ID[]	-	✓

BubbleSets.updateMember(members)

更新成员元素

updateMember(members: ID[] | ((prev: ID[]) => ID[])): void;

参数	描述	类型	默认值	必选
members	元素 ID	ID[] \| ((prev: ID[]) => ID[])	-	✓

BubbleSets 气泡集

配置项

Required type

label

avoidMembers

Required members

Label 样式

label{TextStyleProps}

labelAutoRotate

labelCloseToPath

labelMaxWidth

labelOffsetX

labelOffsetY

labelPlacement

labelBackground

labelPadding

Label Background 样式

labelBackground{RectStyleProps}

API

BubbleSets.addAvoidMember(avoidMembers)

BubbleSets.addMember(members)

BubbleSets.getAvoidMember()

BubbleSets.getMember()

BubbleSets.removeAvoidMember(avoidMembers)

BubbleSets.removeMember(members)

BubbleSets.updateAvoidMember(avoidMembers)

BubbleSets.updateMember(members)