Group

构造一个组合,Group继承自Element

let group = new Group(options);

options

除了支持元素的基础属性外,还支持以下属性:

options.key value description default
w Number 规定组合宽度 --
h Number 规定组合高度 --
clip String|Object 规定裁剪区域 --

TIP

组合可以不设置宽高,这样的组合称为虚拟组合,即没有边界的组合。 虚拟组合没有缓存,也无法绑定事件,可以对其子元素进行事件绑定来替代。 如果组合大小有限,建议设置宽高,缓存机制才能生效。

TIP

clip 的值和 Path 元素的 d 形式相同。

实例属性

property value description example
isVritual Bealoon 是否为虚拟组合 false

实例方法

append(element)

  • 描述:

    向画布中添加一个或多个元素

  • 参数:

    • {Element} element

      TIP

      组合中的元素根据组合的位置定位

  • 示例:

    group.append(element, element2);
    

remove(element)

  • 描述:

    从画布中去除一个或多个元素

  • 参数:

    • {Element} element

TIP

支持不传参数,group.remove()将删除所有的元素

  • 示例:

    group.remove(element);
    

example

let circle = new Circle({
  r: 50,
  y: 50,
  x: 50
});
let group = new Group({
  x: 100,
  y: 100,
  w: 550,
  h: 550,
  stroke: "#ddd"
});
group.append(circle);
group.append(group);