mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-18 00:23:36 +08:00
6.1 KiB
6.1 KiB
RChart 与 useChart
RChart 接收 ECharts options,负责创建实例、更新主题、监听尺寸与清理。需要确定的容器高度;height="100%" 依赖父元素的高度。图表数据和 series 配置由页面管理。
import { RChart, useChart } from '@/components'
import { defineComponent } from 'vue'
export default defineComponent({
setup() {
const [register] = useChart()
return () => (
<RChart
onRegister={register}
preset="card"
title="周订单量"
height={300}
options={{
xAxis: { type: 'category', data: ['周一', '周二', '周三'] },
yAxis: { type: 'value' },
series: [{ type: 'bar', data: [12, 19, 14] }],
}}
/>
)
},
})
交互示例
::: details 查看示例源码 <<< @/../admin/src/views/demo/echart/index.tsx :::
渲染、主题与更新
| 属性 | 默认 | 说明 |
|---|---|---|
options |
{} |
ECharts 配置。showAria 默认 false,模板会写入 aria.enabled 和 aria.decal.show。 |
width / height |
'100%' |
CSS 尺寸,数字按像素。 |
use |
[] |
额外 ECharts 注册项。内置柱、线、饼、K 线、散点、象形柱、Canvas,以及标题、提示、网格、数据集、图例等基础模块。 |
intersectionObserver |
true |
进入观察范围后挂载图表;隐藏区域的实例可能尚不可用。 |
intersectionObserverTarget / intersectionOptions |
容器 / { threshold: 0.1 } |
自定义观察目标与参数。 |
autoResize / autoResizeObserverTarget |
true / 外层容器 |
容器尺寸变化后节流 resize。 |
watchOptions / watchDeep |
true / true |
是否订阅 options,是否深层观察。 |
watchOptionsThrottleWait |
500 |
options 更新节流间隔(毫秒)。 |
nextTick |
true |
初始化前等待 Vue 更新。 |
setChartOptions |
{ notMerge: true, lazyUpdate: true, silent: false, replaceMerge: [] } |
ECharts setOption 的控制参数。 |
theme / autoChangeTheme |
null / true |
默认用应用的 ECharts 主题及暗色变体。固定主题请传注册后的主题名。 |
loading / loadingOptions |
false / 模板加载样式 |
是否显示 ECharts 加载层及参数。 |
Provider 指定主题时优先。当前实现中 theme="default" 在 autoChangeTheme=true 时会传内建 dark,设为 false 才使用空主题名;需要明确的渲染效果时建议传实际主题名。切换主题可能重建实例,持有实例引用的代码应重新读取或注册。
卡片预设和回调
preset="card"使用 Naive UI Card,支持title(字符串或渲染函数)、bordered(默认true)、contentStyle。cardExtra插槽可替换右上角。- 默认菜单含图片下载;
downloadOptions接受 EChartsgetDataURL参数和可选filename。传入dropdownOptions会替换菜单,选择项通过onDropdownSelect(key, option)通知。 onSuccess(instance)、onError()、onFinally()对应初始化结果;错误仍可能向调用侧抛出。onRegister(instance, render, dispose)在可用实例建立后调用。
useChart() 返回 [register, actions]。getChartInstance() 返回 { echartInst, render, dispose },注册前会抛错。isDisposed() 检查底层实例,dispose() 释放图表和监听,render() 调用组件挂载逻辑;已存在实例时不要用它替代更新 options 或 setOption。图表随组件卸载清理。