{"id":13531629,"url":"https://github.com/lulucut/echarts-middleware","last_synced_at":"2025-04-01T19:32:30.336Z","repository":{"id":217027708,"uuid":"126416511","full_name":"lulucut/echarts-middleware","owner":"lulucut","description":"在vue中优雅，高效的使用echarts","archived":false,"fork":false,"pushed_at":"2017-12-20T07:19:21.000Z","size":498,"stargazers_count":6,"open_issues_count":0,"forks_count":9,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-11-02T18:41:34.321Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lulucut.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-23T01:37:03.000Z","updated_at":"2024-01-21T07:37:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"52b63cea-39ad-48e3-92df-7c539d4784e0","html_url":"https://github.com/lulucut/echarts-middleware","commit_stats":null,"previous_names":["lulucut/echarts-middleware"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lulucut%2Fecharts-middleware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lulucut%2Fecharts-middleware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lulucut%2Fecharts-middleware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lulucut%2Fecharts-middleware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lulucut","download_url":"https://codeload.github.com/lulucut/echarts-middleware/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246700718,"owners_count":20819923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T07:01:04.437Z","updated_at":"2025-04-01T19:32:30.329Z","avatar_url":"https://github.com/lulucut.png","language":"Vue","funding_links":[],"categories":["Frameworks"],"sub_categories":["Vue Component"],"readme":"# echarts-middleware\n在vue中优雅，高效的使用echarts,不断完善中\n\n## 快速上手\n\n安装\n\n```\nnpm install -save echarts\nnpm install -save echarts-middleware\n```\n\n引入并注册\n\n```\n\u003cscript\u003e\n  import 'echarts'\n  import Chart from 'echarts-middleware'\n  export default {\n    components: {\n      Chart\n    }\n  }\n\u003c/script\u003e\n```\n\n使用\n```\n\u003ctemplate\u003e\n  \u003cdiv class=\"my-chart\"\u003e\n    \u003cChart :opt=\"data\" :w=\"400\" :h=\"400\"\u003e\u003c/Chart\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\n  import Chart from 'echarts-middleware'\n  export default {\n    components: {\n      Chart\n    },\n    data () {\n      return {\n        data: {\n          'series': [{\n            'name': 'gauge',\n            'type': 'gauge',\n            'detail': {'formatter': '{value}'},\n            'data': [{'value': 34}]\n          }]\n        }\n      }\n    }\n  }\n\u003c/script\u003e\n```\n结果\n![结果](http://my-owo-ink.b0.upaiyun.com/puge/github/echarts-middleware/1.png)\n\n## 组件特点\n* 高效: 直接将echarts实例暴露给vue,可以直接操作\n* 优雅: 自动处理echarts的 注册 及 销毁 操作\n* 简洁: 主要代码少于50行 没有性能损失\n* 接口丰富: 由于直接暴露 echarts实例 所以理论上能用 100% echarts方法\n\n## 简单对比\n\n传统vue中使用echarts\n```\n\u003ctemplate\u003e\n  \u003cdiv class=\"box\"\u003e\n    \u003cdiv class=\"charts\" v-for=\"item in 6\" :id=\"'chart' + item\" :key=\"item\"\u003e\u003c/div\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\n  import echarts from 'echarts'\n  let myChart = []\n  export default {\n    data () {\n      return {\n        mock: {\n          'series': [{\n            'name': 'gauge',\n            'type': 'gauge',\n            'detail': {'formatter': '{value}'},\n            'data': [{'value': 34}]\n          }]\n        }\n      }\n    },\n    created () {\n      for (let i = 0; i \u003c 6; i++) {\n        myChart[i] = echarts.init(document.getElementById('chart' + i))\n        myChart[i].setOption(this.mock)\n      }\n    },\n    beforeDestroy () {\n      for (let i = 0; i \u003c 6; i++) {\n        myChart[i].dispose()\n      }\n    }\n  }\n\u003c/script\u003e\n```\n\n使用echarts-middleware达到同样的效果\n\n```\n\u003ctemplate\u003e\n  \u003cdiv class=\"box\"\u003e\n    \u003cChart class=\"charts\" v-for=\"item in 6\" :opt=\"mock\" :key=\"item\"\u003e\u003c/div\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\n  import echarts from 'echarts'\n  import Chart from 'echarts-middleware'\n  export default {\n    components: {\n      Chart\n    },\n    data () {\n      return {\n        mock: {\n          'series': [{\n            'name': 'gauge',\n            'type': 'gauge',\n            'detail': {'formatter': '{value}'},\n            'data': [{'value': 34}]\n          }]\n        }\n      }\n    }\n  }\n\u003c/script\u003e\n```\n\n## 参数\n\n| 参数        | 含义         | 类型  | 是否必须  |\n| ----------- |:-------------:| -----:| -----:|\n|opt| 图表的配置 | Object | true |\n|w| 图表的宽度| Number | false |\n|h| 图表的高度| Number | false |\n|theme| 主题| String, Object | false |\n|renderer| 渲染器| String | false |\n\n使用实例：\n\n```\n\u003cChart :opt=\"data\" :w=\"400\" :h=\"400\"\u003e\u003c/Chart\u003e\n```\n\n注:如果 w h 参数没有设置，组件会以父组件宽高作为组件宽高， 如果父组件没有宽高则会以400px作为宽高。\n\n\n\n## 获取Echarts对象的方法\n\n1.使用refs取得Echarts实例\n```\n\u003ctemplate\u003e\n  \u003cdiv\u003e\n    \u003cChart ref=\"mychart\" :opt=\"data\" :w=\"400\" :h=\"400\"\u003e\u003c/Chart\u003e\n    \u003cbutton @click=\"click\"\u003e销毁图表\u003c/button\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\u003cscript\u003e\n  import Chart from 'echarts-middleware'\n  export default {\n    components: {\n      Chart\n    },\n    data () {\n      return {\n        data: {\n          'series': [{\n            'name': 'gauge',\n            'type': 'gauge',\n            'detail': {'formatter': '{value}'},\n            'data': [{'value': 34}]\n          }]\n        }\n      }\n    },\n    methods: {\n      click () {\n        const chart = this.$refs['mychart'].chart // 有的版本需要用this.$refs['mychart'][0].chart\n        console.log('输出echarts对象', chart)\n        console.log('销毁echarts图表')\n        chart.dispose()\n      }\n    }\n  }\n\u003c/script\u003e\n```\n2.使用v-model接收echarts实例\n```\n\u003ctemplate\u003e\n  \u003cdiv\u003e\n    \u003cChart v-model=\"chart\" :opt=\"data\" ref=\"mychart\" :w=\"400\" :h=\"400\"\u003e\u003c/Chart\u003e\n    \u003cbutton @click=\"click\"\u003e销毁图表\u003c/button\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\n  import Chart from 'echarts-middleware'\n  export default {\n    components: {\n      Chart\n    },\n    data () {\n      return {\n        data: {\n          'series': [{\n            'name': 'gauge',\n            'type': 'gauge',\n            'detail': {'formatter': '{value}'},\n            'data': [{'value': 34}]\n          }]\n        },\n        chart: null\n      }\n    },\n    methods: {\n      click () {\n        const chart = this.chart\n        console.log('输出echarts对象', chart)\n        console.log('销毁echarts图表')\n        chart.dispose()\n      }\n    }\n  }\n\u003c/script\u003e\n```\n支持的方法，理论支持echarts所有方法，具体方法列表请查阅 [API文档](http://echarts.baidu.com/api.html#echarts)\n\n举例:使用`this.$refs[ref名][0].chart.dispose()` 销毁图表\n\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\n## 常见问题\n1. 图表不刷新？ 解决办法： 使用 :key\n\n2.错误问题: __DEV__ is not defined\n  解决方法:\n  ```\n  在 webpack的配置里面加一个配置\n\n  plugins: [\n    new webpack.DefinePlugin({\n      __DEV__: false\n    })\n  ]\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flulucut%2Fecharts-middleware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flulucut%2Fecharts-middleware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flulucut%2Fecharts-middleware/lists"}