Group

实例方法

向分组中添加新的分组。

参数

用法

group.addGroup({
  id: 'groupId',
});

addShape(type, cfgs)

向分组中添加新的图形。注意：在分组上添加的clip， transform等会影响到该分组中的所有图形。G支持的图形及其绘图属性请见shape小节。

参数

用法

group.addShape('rect', {
  attrs: {
    fill: 'red',
    shadowOffsetY: 10,
    shadowColor: 'blue',
    shadowBlur: 10,
    opacity: 0.8,
  },

contain(child)

该分组是否包含此元素。返回值: boolean

参数

用法

const has = group.contain(child);

find(fn)

根据指定条件返回对应元素，只返回符合条件的第一个元素。

参数

根据元素ID返回对应的实例。返回值：Object。

参数

用法

const group1 = group.findById('group1');

findAll(fn)

返回所有符合条件的元素。返回值: [ Object ]

参数

用法

const children = group.findAll(function(item) {
  return item.get('id') < 10; // 获取所有id小于10的元素

getShape(x,y)

返回该坐标点最上层的元素。返回值: Object

参数

用法

// 获取 (10, 30) 坐标点上层的元素
const element = group.getShape(10, 30);

getFirst()

获取该分组的第一个子元素。返回值: Object

用法

用法

const child = group.getLast();
// 等价于
const childrens = group.get('children');
const child = childrens[childrens.length - 1];

getChildByIndex(index）

返回第 index 个子元素，从0开始计数。返回值: Object

参数

用法

const child = group.getChildByIndex(2);

removeChild(child)

从分组中删除一个分组或一个图形。

参数说明

用法

sort()

排序方法。一般用于在设置子元素层叠顺序时使用。

典型使用场景：通过 group.addShape() 添加 shape 时，添加的每个 shape 都设置了 index，在最后调用 group.sort() 可以对添加的 shape 进行排序。

用法

清除该组的所有子元素。

group.clear();