目錄

• 前言
• 1.自定義圖形最后的效果是這樣的：
• 2.注冊自定義的圖形
• 3.extendShape
• 4.使用echarts注冊這三個圖形
• 5.使用自定義的形狀
• 總結(jié)

前言

在一個前端大屏項目中，有一個模塊使用到了自定義的，由三個面組成的偽3D柱形圖。在此處記錄一下，方便后續(xù)自定義的時候參考一下。涉及到了zrender里面的一些方法，還特意去zrender看了些示例和文檔。

1.自定義圖形最后的效果是這樣的：

圖形由三個面組成，需要定義三個形狀。用cubeleft,cubetop,cuberight來分別定義左側(cè)面，頂部面以及右側(cè)面。

2.注冊自定義的圖形

echarts官方文檔處：Documentation - Apache ECharts

我們需要定義一個這樣的類，然后再通過echarts來注冊這個類，后續(xù)就可以通過類名來使用了。

3.extendShape

    // 繪制左側(cè)面    const CubeLeft = echarts.graphic.extendShape({    shape: {x: 0,y: 0    },    buildPath: function(ctx, shape) {const xAxisPoint = shape.xAxisPointconst c0 = [shape.x, shape.y]const c1 = [shape.x - 13, shape.y - 13]const c2 = [xAxisPoint[0] - 13, xAxisPoint[1] - 13]const c3 = [xAxisPoint[0], xAxisPoint[1]]ctx.moveTo(c0[0], c0[1]).lineTo(c1[0], c1[1]).lineTo(c2[0], c2[1]).lineTo(c3[0], c3[1]).closePath()    }     })    // 繪制右側(cè)面    const CubeRight = echarts.graphic.extendShape({    shape: {x: 0,y: 0    },    buildPath: function(ctx, shape) {const xAxisPoint = shape.xAxisPointconst c1 = [shape.x, shape.y]const c2 = [xAxisPoint[0], xAxisPoint[1]]const c3 = [xAxisPoint[0] + 18, xAxisPoint[1] - 9]const c4 = [shape.x + 18, shape.y - 9]ctx.moveTo(c1[0], c1[1]).lineTo(c2[0], c2[1]).lineTo(c3[0], c3[1]).lineTo(c4[0], c4[1]).closePath()    }})    // 繪制頂面    const CubeTop = echarts.graphic.extendShape({    shape: {x: 0,y: 0    },    buildPath: function(ctx, shape) {const c1 = [shape.x, shape.y]const c2 = [shape.x + 18, shape.y - 9]const c3 = [shape.x + 5, shape.y - 22]const c4 = [shape.x - 13, shape.y - 13]ctx.moveTo(c1[0], c1[1]).lineTo(c2[0], c2[1]).lineTo(c3[0], c3[1]).lineTo(c4[0], c4[1]).closePath()    }     })

這段代碼主要是看buildpath如何使用，zrender的官方文檔中，并沒有直接告訴這個方法的兩個參數(shù)是干什么用的，只給了一個示例，從這個示例中，可以知道這兩個參數(shù)具體怎么用。

示例網(wǎng)址：https://github.com/ecomfe/zrender/blob/master/test/pin.html

第一個參數(shù)是path，第二參數(shù)是shape。path可以理解為一個canvas中的繪制畫筆，可以設(shè)置路徑并且閉合路徑。

第二個參數(shù)在echarts中，是自定義的custom傳遞過來的，因此可以通過這個對象獲取到我們一個很熟悉的屬性 xAxisPoint。

繪制的兩個面中，只有左側(cè)和右側(cè)面需要有填充高度，頂部不需要，所以頂部的形狀就沒有使用xAxisPoint這個屬性。

這也是很好理解的，因為我們自定義的偽圓柱體里面的填充物肯定是有一個高度的。填充多少根據(jù)我們的數(shù)據(jù)來知道，讓它看起來確實(shí)是被某種東西從底部開始增多填充了。

拿比較簡單的頂部來舉例：

buildPath: function(ctx, shape) {    const c1 = [shape.x, shape.y]    const c2 = [shape.x + 18, shape.y - 9]    const c3 = [shape.x + 5, shape.y - 22]    const c4 = [shape.x - 13, shape.y - 13]    ctx.moveTo(c1[0], c1[1]).lineTo(c2[0], c2[1]).lineTo(c3[0], c3[1]).lineTo(c4[0],c4[1]).closePath()}

繪制的四邊形，其實(shí)就是四個頂點(diǎn)，我們只需要用moveTo來控制路徑就行，在最后那個點(diǎn)進(jìn)行閉合就行。偏移量是固定的值，可以根據(jù)情況自己去設(shè)置不同的值來扭曲這個四邊形。

其中c1是底部的頂點(diǎn)，c2是右側(cè)的頂點(diǎn)，c3是頂部的頂點(diǎn)，c4是右側(cè)的頂點(diǎn)。其他兩個面也是類似的。

4.使用echarts注冊這三個圖形

// 注冊三個面圖形    echarts.graphic.registerShape("CubeLeft", CubeLeft)    echarts.graphic.registerShape("CubeRight", CubeRight)    echarts.graphic.registerShape("CubeTop", CubeTop)

5.使用自定義的形狀

其他的數(shù)據(jù)都和正常使用echarts一樣，不同的地方在于series的配置。

series數(shù)組中，總共放置二個對象。第一個對象如下：

{type: "custom",renderItem: function(params, api) {    const location = api.coord([api.value(0), api.value(1)])    return {type: "group",children: [{    type: "CubeLeft",    shape: {api,x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: "rgba(47,102,192,.27)",stroke: "black"    },    z2: 999}, {    type: "CubeRight",    shape: {api,x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: "rgba(59,128,226,.27)",stroke: "black"    },    z2: 999}, {    type: "CubeTop",    shape: {api,x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: "rgba(72,156,221,.27)",stroke: "black"    },    z2: 999}]    }},data: MAX}

最主要的還是renderItem里面的邏輯，這個方法返回一個對象，對象就是我們自定義的一個group組。renderItem可以返回的對象在文檔中都有說明：Documentation - Apache ECharts

我們定義的那三個面，需要把它看成一個整體，所以renderItem返回的是一個類型為group的對象，另外三個形狀作為children保存在數(shù)組中。

其中的shape參數(shù)，會在buildpath中使用到。

style中設(shè)置了它的填充顏色和邊框線顏色。然后使用z2定義這個echarts的顯示層級為最上級。如果不使用它，下面用于填充的會將其遮擋住。

這里也只是定義了第一個自定義的形狀，也就是最外層的那個偽3d柱體。第二個自定義形狀是要填充的形狀。

{type: "custom",renderItem: (params, api) => {    const location = api.coord([api.value(0), api.value(1)])    var color = new echarts.graphic.LinearGradient(0, 0, 0, 1, [{offset: 1,color: "#FEFD53"    },    {offset: 0,color: "#f7c824"    }]    );    return {type: "group",children: [{    type: "CubeLeft",    shape: {api,xValue: api.value(0),yValue: api.value(1),x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: color,stroke: "red"    }}, {    type: "CubeRight",    shape: {api,xValue: api.value(0),yValue: api.value(1),x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: color,stroke: "red"    }}, {    type: "CubeTop",    shape: {api,xValue: api.value(0),yValue: api.value(1),x: location[0],y: location[1],xAxisPoint: api.coord([api.value(0), 0])    },    style: {fill: color,stroke: "red"    }}]    }},data: VALUE}

內(nèi)部填充的圖形，使用了一個線性漸變的顏色用來填充。邊框線使用紅色。與第一個不同的是，style里面的風(fēng)格，以及data使用的數(shù)據(jù)。這里的data使用value具體的數(shù)值。而外殼的圖形使用的數(shù)據(jù)是max最大值。這樣就會有一個漸變顏色填充的紅色邊框圖形，填充到了一個黑色邊框的柱體中。

這樣就自定義好了一個視覺上的3d柱體形狀的圖表了。

總結(jié)

到此這篇關(guān)于Echarts自定義圖形的文章就介紹到這了,更多相關(guān)Echarts自定義圖形內(nèi)容請搜索以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持！