shape

rangeY

text

开始使用

上图中的「数据保密」的徽章图案就是使用 shape 绘制。在绘制图形时，可以从图表上下文中获取 document 对象，随后使用 document.createElement 创建基础图形。在下面的示例中我们创建了一个 Circle。

{
  annotations: [
    {
      type: 'shape',
      style: {
        x: '80%',
        y: '70%',
        render: ({ x, y }, context, d) => {
          const { document } = context;
          const g = document.createElement('g', {});
          const c1 = document.createElement('circle', {
            style: {
              cx: x,
              cy: y,
              lineWidth: 4,
              r: 65,
              stroke: 'red',
              opacity: 0.3,
            },
          });
          const c2 = document.createElement('circle', {
            style: {
              cx: x,
              cy: y,
              lineWidth: 2,
              r: 50,
              stroke: 'red',
              opacity: 0.3,
            },
          });
          const text = document.createElement('text', {
            style: {
              x,
              y,
              text: '数据保密',
              transform: 'rotate(30)',
              fontSize: 20,
              fill: 'red',
              textAlign: 'center',
              textBaseline: 'middle',
              fillOpacity: 0.3,
            },
          });
          g.appendChild(c1);
          g.appendChild(c2);
          g.appendChild(text);
          return g;
        },
      },
    },
  ],
};

选项

属性	描述	类型	默认值	-
x	设置图形的位置 x，支持百分比（`'50%'`）和像素值（`200`）	`number`	`string`	-
y	设置图形的位置 y，支持百分比（`'50%'`）和像素值（`200`）	`number`	`string`	-
render	对应的自定义渲染函数，函数需要返回 G 的 DisplayObject	`(style: object) => DisplayObject`	-
{ ...rest }	自定义图形的额外参数，都会作为 `render` 函数的第一个参数属性	`object`	-