Echarts graphic原生图形元素组件

前面的文章介绍了Echarts通用配置项，这篇文章进入第二个主题介绍：Echarts graphic原生图形元素组件。

graphic 是原生图形元素组件。可以支持的图形元素包括：
Image, Text, Circle, Sector, Ring, Rect, Polygon, Polyline, Line, BezierCurve, Arc, Group 。这篇文章分别介绍graphic的通用设置，以及通用事件，接下来会分别介绍每种图形的绘制方法。

一、graphic的通用配置

{
    // id 用于在更新图形元素时指定更新哪个图形元素，如果不需要用可以忽略。
    id: 'xxx',

    // 这个字段在第一次设置时不能忽略，取值见上方『支持的图形元素』。
    type: 'image',

    // 下面的各个属性如果不需要设置都可以忽略，忽略则取默认值。

    // 指定本次 setOption 对此图形元素进行的操作。默认是 'merge'，还可以 'replace' 或 'remove'。
    $action: 'replace',

    // 这是四个相对于父元素的定位属性，每个属性可取『像素值』或者『百分比』或者 'center'/'middle'。
    left: 10,
    // right: 10,
    top: 'center',
    // bottom: '10%',

    shape: {
        // 定位、形状相关的设置，如 x, y, cx, cy, width, height, r, points 等。
        // 注意，如果设置了 left/right/top/bottom，这里的定位用的 x/y/cx/cy 会失效。
    },

    style: {
        // 样式相关的设置，如 fill, stroke, lineWidth, shadowBlur 等。
    },
   // 表示 z 高度，从而指定了图形元素的覆盖关系。
    z: 10,
    // 表示不响应事件。
    silent: true,
    // 表示节点不显示
    invisible: false,
    // 设置是否整体限制在父节点范围内。可选值：'raw', 'all'。
    bouding: 'raw',
    // 是否可以被拖拽。
    draggable: false,
    // 事件的监听器，还可以是 onmousemove, ondrag 等。支持的事件参见下。
    onclick: function () {...}
}

二、graphic的通用事件

支持这些事件配置： onclick, onmouseover, onmouseout, onmousemove, onmousewheel, onmousedown, onmouseup, ondrag, ondragstart, ondragend, ondragenter, ondragleave, ondragover, ondrop

三、绘制方法

按照形状的类别，把这些分为六类。

1、Image

Image: 图形

Demo:

Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'image',
        id: 'logo',
        right: 20,
        top: 20,
        z: -10,
        //'all'：（默认） 表示用自身以及子节点整体的经过 transform 后的包围盒进行定位。 这种方式易于使整体都限制在父元素范围中。
       //'raw'： 表示仅仅用自身（不包括子节点）的没经过 tranform 的包围盒进行定位。 这种方式易于内容超出父元素范围的定位方式。
        bounding: 'raw',
        origin: [75, 75],
        style: {
            image: 'http://echarts.baidu.com/images/favicon.png',
            width: 150,
            height: 150,
            opacity: 0.4
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

2、Group, Rect, Text

Group: 组，把各个元素都包起来
Rect: 矩形，绘制矩形就是指定宽度，高度
Text: 文案

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: [
        {
            type: 'group',
            rotation: Math.PI / 4,
            bounding: 'raw',
            right: 110,
            bottom: 110,
            z: 100,
            children: [
                {
                    type: 'rect',
                    left: 'center',
                    top: 'center',
                    z: 100,
                    shape: {
                        width: 400,
                        height: 50
                    },
                    style: {
                        fill: 'rgba(0,0,0,0.3)'
                    }
                },
                  {
                    type: 'text',
                    left: 'center',
                    top: 'center',
                    z: 100,
                    style: {
                        fill: '#fff',
                        text: 'ECHARTS BAR CHART',
                        font: 'bold 26px Microsoft YaHei'
                    }
                }
            ]
        },
        {
            type: 'group',
            left: '10%',
            top: 'center',
            children: [
                {
                    type: 'rect',
                    z: 100,
                    left: 'center',
                    top: 'middle',
                    shape: {
                        width: 190,
                        height: 90
                    },
                    style: {
                        fill: '#fff',
                        stroke: '#555',
                        lineWidth: 2,
                        shadowBlur: 8,
                        shadowOffsetX: 3,
                        shadowOffsetY: 3,
                        shadowColor: 'rgba(0,0,0,0.3)'
                    }
                },
                  {
                    type: 'text',
                    z: 100,
                    left: 'center',
                    top: 'middle',
                    style: {
                        fill: '#333',
                        text: [
                            '横轴表示温度，单位是°C',
                            '纵轴表示高度，单位是km',
                            '右上角有一个图片做的水印',
                            '这个文本块可以放在图中各',
                            '种位置'
                        ].join('\n'),
                        font: '14px Microsoft YaHei'
                    }
                }
            ]
        }
    ],
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

3、Circle, Ring, Sector，Arc

先介绍几个概念：
Circle: 圆形，这个无需多介绍
Ring: 戒指，这里代表双圆
Sector: 扇形，扇形是圆的一部分，扇形是一条弧和经过这条弧两端的两条半径所围成的图形, 是封闭的
Arc: 弧形, 弧形只是一段曲线，不是封闭图形
绘制圆，一般需要知道圆心的坐标，圆的半径就可以，Ring，Sector, Arc 比Circle多了一个属性r0(里圆的半径)

Circle Demo:

Circle Code：

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'circle',
        id: 'circle',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            cx: 50,
            cy: 50,
            r: 50
        },
        style: {
            fill: '#fff',
            stroke: 'red'
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

Ring Demo:

Ring Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
        type: 'ring',
        id: 'ring',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            cx: 50,
            cy: 50,
            r: 50,
            r0: 20,
        },
        style: {
            fill: '#fff',
            stroke: 'red',
            lineWidth: 1
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

Sector Demo:

Sector Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
        type: 'sector',
        id: 'sector',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            cx: 50,
            cy: 50,
            r: 50,
            r0: 20,
            //startAngle: 0,
            //endAngle: Math.PI * 2,
            //clockwise: true
        },
        style: {
            fill: '#fff',
            stroke: 'red',
            lineWidth: 1
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

Arc的shape写法与Sector的写法相似，这里不多介绍了。

4、Polygon, Polyline

Polygon：顾明思议就是多边形
Polyline：也就是多条线，
多边形其实是可以画任意形状，他的shape是一个数组，[[10, 20], [20, 30]..]只要指定好坐标就可以了。Polyline跟Polygon的主要区别就是结尾是否连接起来。

Polygon Demo：

Polygon Code：

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'polygon',
        id: 'polygon',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            points: [[22, 44], [44, 55], [11, 44],  [80, 90]]
        },
        style: {
            fill: '#fff',
            stroke: 'red'
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

Polyline Demo:

Polyline Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'polyline',
        id: 'polyline',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            points: [[22, 44], [44, 55], [11, 44],  [80, 90]]
        },
        style: {
            fill: '#fff',
            stroke: 'red'
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

5、Line

Line 线，一般绘制一条线，告诉开始坐标，结束坐标就能把线绘制出来。我们看看下面的实例：
Line Demo:

Line Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'line',
        id: 'line',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            x1: 50,
            y1: 100,
            x2: 80,
            y2: 300
        },
        style: {
            fill: '#fff',
            stroke: 'blue'
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};

6、BezierCurve

BezierCurve: 贝塞尔曲线， Bezier曲线是应用于二维图形的曲线。曲线由顶点和控制点组成，通过改变控制点坐标可以改变曲线的形状。
所以绘制点一般有开始点坐标，结束点坐标，还有控制点坐标。

BezierCurve Demo:

BezierCurve Code:

option = {
    title: {
        text: 'Awesome Chart'
    },
    xAxis: {
        data: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
    },
    graphic: {
      type: 'bezierCurve',
        id: 'bezierCurve',
        right: 50,
        top: 20,
        origin: [75, 75],
        shape: {
            x1: 50,
            x2: 50,
            y1: 400,
            y2: 400,
            cpx1: 60,
            cpy1: 60,
            cpx2: 300,
            cpy2: 300,
            percent: 80
        },
        style: {
            fill: '#fff',
            stroke: 'blue'
        }
    }, 
    yAxis: {},
    series: [{
        type: 'line',
        data:[220, 182, 191, 234, 290, 330, 310]
    }]
};
  [1]: https://segmentfault.com/a/1190000019667988