1.0.0 • Published 3 years ago

echart5-canvars-ssr v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
3 years ago

echarts5-canvas-ssr

Echarts server side render by node canvas, generate chart image by Echarts. Upgrade Echarts version to 5. 使用NodeJs服务器端渲染echarts图表,生成图片格式。将Echarts版本提升到5.

forked from neilli1024/node-echarts-canvas , 2 changes:

  1. update echarts version to 5.
  2. use neilli1024/echarts-ssr-server's http access.
  3. merge ecomfe/echarts-wordcloud to project. Modify to support server-side create.

Install

OSCommand
OS Xbrew install pkg-config cairo pango libpng jpeg giflib
Ubuntusudo apt-get install libcairo2-dev libjpeg8-dev libpango1.0-dev libgif-dev build-essential g++
Fedorasudo yum install cairo cairo-devel cairomm-devel libjpeg-turbo-devel pango pango-devel pangomm pangomm-devel giflib-devel
Solarispkgin install cairo pango pkg-config xproto renderproto kbproto xextproto
WindowsInstructions on our wiki
npm install node-echarts-canvas

Usage

var echarts = require('node-echarts-canvas');
var config = {
    width: 500, // Image width, type is number.
    height: 500, // Image height, type is number.
    option: {}, // Echarts configuration, type is Object.
    //If the path  is not set, return the Buffer of image.
    path: '', // Path is filepath of the image which will be created.
    enableAutoDispose: true  //Enable auto-dispose echarts after the image is created.
}

echarts(config)

Config

nametypedefaultdescription
widthNumber500Image width
heightNumber500Image height
optionObject{}Echarts Options
pathString-Path is filepath of the image which will be created. If the path is empty, return buffer.
enableAutoDisposeBooleantrueEnable auto-dispose echarts after the image is created.

Http access

Usage

Using http post to fetch a picture.

Install

Method 1 : Using docker (not finish yet)

docker run -d -p 8081:8081 --name echarts-ssr-server --restart=always mosliu/echart5-canvars-ssr

Method 2 : Run with Node.

1. 安装依赖

操作系统安装命令
OS Xbrew install pkg-config cairo pango libpng jpeg giflib
Ubuntusudo apt-get install libcairo2-dev libjpeg8-dev libpango1.0-dev libgif-dev build-essential g++
Fedorasudo yum install cairo cairo-devel cairomm-devel libjpeg-turbo-devel pango pango-devel pangomm pangomm-devel giflib-devel
Solarispkgin install cairo pango pkg-config xproto renderproto kbproto xextproto
WindowsInstructions on our wiki

2. 下载并安装

git clone git@github.com:jessezhang007007/echarts-ssr-server.git
cd echarts-ssr-server
npm install
npm start

三、访问服务

1. 访问方式:使用http请求访问服务

2. 请求参数格式:

{
    "width": 800,
        "height": 500,
        "option": {
        "backgroundColor": "#fff",
            "xAxis": {
            "type": "category",
                "data": [
                "Mon",
                "Tue",
                "Wed",
                "Thu",
                "Fri",
                "Sat",
                "Sun"
            ]
        },
        "yAxis": {
            "type": "value"
        },
        "series": [{
            "data": [
                820,
                932,
                901,
                934,
                1290,
                1330,
                1320
            ],
            "type": "line"
        }]
    }
}

参数JSON里的第一层属性说明:

属性名类型默认值说明
widthNumber600图片宽度
heightNumber400图片高度
optionObject{}Echarts 的 Option 配置,参考Echarts文档

3. GET方式访问

注意:GET方式只适合参数数据量小的情况,参数数据量大的时候请使用POST方式。

http://localhost:8081/?config=%7B%22width%22%3A800%2C%22height%22%3A500%2C%22option%22%3A%7B%22backgroundColor%22%3A%22%23fff%22%2C%22xAxis%22%3A%7B%22type%22%3A%22category%22%2C%22data%22%3A%5B%22Mon%22%2C%22Tue%22%2C%22Wed%22%2C%22Thu%22%2C%22Fri%22%2C%22Sat%22%2C%22Sun%22%5D%7D%2C%22yAxis%22%3A%7B%22type%22%3A%22value%22%7D%2C%22series%22%3A%5B%7B%22data%22%3A%5B820%2C932%2C901%2C934%2C1290%2C1330%2C1320%5D%2C%22type%22%3A%22line%22%7D%5D%7D%7D

4. POST方式访问

curl -X POST \
  http://localhost:8081/ \
  -o echart-image.png \
  -d '{
    "width": 800,
    "height": 500,
    "option": {
    	"backgroundColor": "#fff",
        "xAxis": {
            "type": "category",
            "data": [
                "Mon",
                "Tue",
                "Wed",
                "Thu",
                "Fri",
                "Sat",
                "Sun"
            ]
        },
        "yAxis": {
            "type": "value"
        },
        "series": [
            {
                "data": [
                    820,
                    932,
                    901,
                    934,
                    1290,
                    1330,
                    1320
                ],
                "type": "line"
            }
        ]
    }
}'