更新记录

0.0.1（2026-05-02）

新增

• 新增 ECharts 配置封装组件 ze-echart。
• 支持接收 option 配置和 theme 属性。
• 支持加载状态和空配置状态。
• 支持 ready、finished 事件。
• 支持 setOption(option)、resize()、dispose()、getInstance() 方法。

优化

• 补充完整首页 demo，覆盖 option 配置、ready/finished 状态、resize 和 dispose 截图场景。
• demo 增加配置切换、空配置展示和 setOption() 方法调用。
• 插件定位调整为 ECharts 配置适配器，避免误导为内置完整 ECharts 渲染内核。
• 补充详情页级 readme.md，明确 API、平台兼容性和能力边界。
• 完善插件市场发布配置、平台兼容性、授权价格和文档说明。

注意

• 当前是 ECharts 配置承载层，不包含真实 ECharts 渲染内核。
• 如需完整 ECharts 能力，需要后续接入 H5 Canvas 或 WebView 渲染方案。

平台兼容性

uni-app(5.08)

uni-app x(5.08)

其他

ECharts 配置适配器

zhuanz-echart 是一个 ECharts option 配置适配组件，提供统一的图表容器、配置接收、生命周期事件和基础方法封装。

定位说明

当前版本定位为“配置适配器”和“图表容器基础层”，不内置完整 ECharts 渲染内核。适合需要先统一图表配置结构、生命周期和后续渲染接入点的项目。

组件

• ze-echart

核心能力

• 接收 option 配置。
• 支持 theme 属性。
• 支持加载状态和空配置状态。
• 提供 ready、finished 事件。
• 提供 setOption(option)、resize()、dispose()、getInstance() 方法。

安装路径

uni_modules/zhuanz-echart

基础示例

<template>
  <ze-echart
    ref="chart"
    :option="option"
    theme="light"
    @ready="onReady"
    @finished="onFinished"
  />
</template>

<script>
export default {
  data() {
    return {
      option: {
        title: { text: '销售趋势' },
        series: [{ type: 'bar', data: [12, 30, 18] }]
      }
    }
  },
  methods: {
    onReady() {},
    onFinished() {},
    updateChart() {
      this.$refs.chart.setOption(this.option)
    }
  }
}
</script>

Props

Events

Methods

平台兼容性

• uni-app Vue2 / Vue3：支持
• H5：支持
• App Vue：支持
• 微信小程序：支持
• 支付宝小程序：支持
• uni-app x：支持 Web 和 App，需按实际项目运行环境验证

注意事项

• 当前版本不内置 ECharts 渲染内核。
• 上架和项目文案请描述为“ECharts 配置适配器”或“图表配置容器”。
• 如需真实图表渲染，建议后续接入 H5 Canvas、WebView 或平台图表渲染方案。