@fbkworks/chart-core 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/FbkChart.vue.mjs +35 -13
- package/dist/FbkChart.vue.mjs.map +1 -1
- package/package.json +1 -1
package/dist/FbkChart.vue.mjs
CHANGED
|
@@ -20,6 +20,22 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
20
20
|
},
|
|
21
21
|
emits: ["ready", "click", "resize", "error"],
|
|
22
22
|
setup(__props, { expose: __expose, emit: __emit }) {
|
|
23
|
+
const SHAPE_COMPONENT_KEYS = [
|
|
24
|
+
"dataZoom",
|
|
25
|
+
"visualMap",
|
|
26
|
+
"xAxis",
|
|
27
|
+
"yAxis",
|
|
28
|
+
"grid",
|
|
29
|
+
"tooltip",
|
|
30
|
+
"polar",
|
|
31
|
+
"radar",
|
|
32
|
+
"angleAxis",
|
|
33
|
+
"radiusAxis",
|
|
34
|
+
"timeline",
|
|
35
|
+
"graphic",
|
|
36
|
+
"dataset",
|
|
37
|
+
"title"
|
|
38
|
+
];
|
|
23
39
|
const props = __props;
|
|
24
40
|
const emit = __emit;
|
|
25
41
|
const container = ref();
|
|
@@ -38,27 +54,32 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
38
54
|
if (!list.length) return true;
|
|
39
55
|
return list.every((s) => !s?.data || Array.isArray(s.data) && s.data.length === 0);
|
|
40
56
|
});
|
|
57
|
+
let liveComponentKeys;
|
|
41
58
|
function applyOption() {
|
|
42
59
|
const instance = chart.value;
|
|
43
60
|
if (!instance) return;
|
|
44
61
|
try {
|
|
45
62
|
const resolved = resolveOptionVars(props.option);
|
|
63
|
+
const nextKeys = new Set(
|
|
64
|
+
SHAPE_COMPONENT_KEYS.filter(
|
|
65
|
+
(key) => resolved?.[key] !== void 0
|
|
66
|
+
)
|
|
67
|
+
);
|
|
68
|
+
const vanished = liveComponentKeys ? [...liveComponentKeys].some((key) => !nextKeys.has(key)) : false;
|
|
46
69
|
if (props.loading) {
|
|
47
70
|
instance.showLoading("default", { text: "", color: "#3b82f6", maskColor: "rgba(255,255,255,0.6)" });
|
|
48
71
|
}
|
|
49
|
-
instance.setOption(
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
lazyUpdate: false
|
|
61
|
-
});
|
|
72
|
+
instance.setOption(
|
|
73
|
+
resolved,
|
|
74
|
+
vanished ? { notMerge: true, lazyUpdate: false } : {
|
|
75
|
+
/* 形状不变时走 replaceMerge:它精确处理「系列变少」与「图例该消失」,
|
|
76
|
+
其余组件照旧合并,因此动画和缩放位置都不会被重置。
|
|
77
|
+
(纯合并 notMerge:false 做不到这两件事:系列会残留、图例移不掉。) */
|
|
78
|
+
replaceMerge: ["series", "legend"],
|
|
79
|
+
lazyUpdate: false
|
|
80
|
+
}
|
|
81
|
+
);
|
|
82
|
+
liveComponentKeys = nextKeys;
|
|
62
83
|
} catch (err) {
|
|
63
84
|
emit("error", err);
|
|
64
85
|
}
|
|
@@ -81,6 +102,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
81
102
|
return;
|
|
82
103
|
}
|
|
83
104
|
chart.value = instance;
|
|
105
|
+
liveComponentKeys = void 0;
|
|
84
106
|
instance.on("click", (params) => emit("click", params));
|
|
85
107
|
applyOption();
|
|
86
108
|
emit("ready", instance);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FbkChart.vue.mjs","sources":["../src/FbkChart.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, onMounted, ref, shallowRef, useAttrs, watch } from 'vue'\nimport { init, type ECharts } from 'echarts/core'\nimport { registerFbkCharts } from './register'\nimport { resolveOptionVars } from './color'\nimport { resolveChartTheme } from './theme'\nimport type { FbkChartOption } from './types'\n\n/**\n * ECharts 容器组件。\n *\n * 职责边界(都是手写时最容易漏的):\n * · 生命周期:init / dispose,卸载时必须 dispose,否则实例泄漏\n * · 尺寸变化:ResizeObserver 而非 window.resize —— 容器在 flex/grid 里\n * 变化时 window 不会触发 resize,图表会保持旧尺寸\n * · 主题切换:监听 data-fbk-theme 变化并重新应用主题\n * · 空态:没有数据时不该渲染一个空白坐标系\n */\ndefineOptions({ name: 'FbkChart', inheritAttrs: false })\n\nconst props = withDefaults(\n defineProps<{\n /** ECharts option。类型刻意放宽,避免 echarts 类型进入公开契约 */\n option: FbkChartOption\n /** 高度,数字按 px 处理 */\n height?: string | number\n /** 是否显示加载态 */\n loading?: boolean\n /** 是否自动应用 FBK 主题 */\n themed?: boolean\n /** 空数据提示。传空字符串关闭空态 */\n emptyText?: string\n /** 空数据判定:默认检查 option.series 是否为空 */\n isEmpty?: boolean\n }>(),\n {\n height: undefined,\n loading: false,\n themed: true,\n emptyText: '暂无数据',\n isEmpty: undefined,\n },\n)\n\nconst emit = defineEmits<{\n ready: [chart: ECharts]\n click: [params: Record<string, any>]\n /** 尺寸变化(缩放后) */\n resize: [size: { width: number; height: number }]\n /**\n * 图表初始化或渲染失败。\n *\n * 不传时组件降级为空态,不抛到全局 —— 一个图表渲染失败\n * 不该让整页白屏。\n */\n error: [error: unknown]\n}>()\n\nconst container = ref<HTMLDivElement>()\nconst chart = shallowRef<ECharts>()\n/* 曾经有个 themeVersion ref 在这里,只写不读 —— 主题切换靠的是直接 create(),\n 那个计数器从来没参与任何逻辑。删掉,免得下一个人以为它是那条链路的开关。 */\n\n/* inheritAttrs: false 时必须手动转发 attrs,否则调用方的 class/style 会静默失效。\n attrs 落点是根 div:它既是 .fbk-chart(position: relative)的定位容器,\n 也是 position: absolute; inset: 0 的 canvas 的父级 —— 外部 style 只有落在这里才会影响布局。 */\nconst attrs = useAttrs()\n\nconst style = computed(() => {\n const h = props.height\n if (h === undefined) return {}\n return { height: typeof h === 'number' ? `${h}px` : h }\n})\n\n/** 默认空态判定:series 为空或所有系列都没有 data */\nconst resolvedEmpty = computed(() => {\n if (props.isEmpty !== undefined) return props.isEmpty\n const series = props.option?.series\n if (!series) return true\n const list = Array.isArray(series) ? series : [series]\n if (!list.length) return true\n return list.every((s: any) => !s?.data || (Array.isArray(s.data) && s.data.length === 0))\n})\n\nfunction applyOption() {\n const instance = chart.value\n if (!instance) return\n\n try {\n /* 必须先解析 CSS 变量:ECharts 用 Canvas 绘制,不认 var(--x),\n 直接传会抛 \"could not be parsed as a color\" 并且图表不上色。 */\n const resolved = resolveOptionVars(props.option)\n /* 用 replaceMerge 而不是 notMerge:false。\n 纯合并(notMerge:false)有两个实测后果:\n 1. 系列变少时旧系列继续渲染 —— 用户筛掉一条线,画面上仍然留着它和它的旧数据;\n 2. 新配置里没有 legend 时图例不会被移除(合并语义下「没给」=「别动」)。\n replaceMerge 只替换这两类组件、其余照旧合并,所以动画与其它状态都保住了。\n 这也是那四个图表组件敢用「series.length > 1 ? legend : undefined」这种写法\n 的前提 —— 否则去掉的那一半根本不生效。 */\n /* 重建实例(主题切换)后遮罩会跟着旧实例一起没了,而 props.loading 没变、\n watcher 不会触发 —— 结果是「loading=true 却看不到遮罩」,看起来像加载完了。 */\n if (props.loading) {\n instance.showLoading('default', { text: '', color: '#3b82f6', maskColor: 'rgba(255,255,255,0.6)' })\n }\n\n instance.setOption(resolved as any, {\n /* 只替换「可能整块消失」的组件类型。\n 实测:series / legend / dataZoom 在新 option 里被删掉后,\n 纯合并会把它们留在实例上(折线↔饼这类换图型会留下空坐标系与残留缩放条)。\n xAxis / yAxis / grid 不在这里 —— 它们的增减在合并语义下能正确归一\n (实测轴互换后 axisLabel 的 width/overflow 被丢弃、axisLine.show 归一),\n 换成 replaceMerge 反而会让坐标轴动画每帧重建。 */\n /* 只能点名**已注册**的组件。register.ts 里没有 geo,\n 点名它会直接让 echarts 崩掉(大屏整页图表消失,CI 的视觉回归当场红)——\n 没注册的组件本来也不可能出现在 option 里,不必也不该列进来。 */\n replaceMerge: ['series', 'legend'],\n lazyUpdate: false,\n })\n } catch (err) {\n /* setOption 抛错通常是配置写错(渐变色的非法值、series 结构不对)。\n 捕获后上报,图表保留上一帧而不是整页崩。 */\n emit('error', err)\n }\n}\n\nfunction create() {\n const el = container.value\n if (!el) return\n\n /* 关键:ECharts 在 init 时会读取容器的 clientWidth/clientHeight 并**固定**下来。\n 如果此时容器高度是 0(flex / grid 布局里常见),它会写下\n `height: 0px` 的行内样式,之后 resize() 也无法恢复 —— 图表永久空白。\n\n 所以:容器没有高度时先不 init,等 ResizeObserver 报出有效尺寸再建。\n 这是大屏里\"图表全空白\"的真正原因。 */\n if (!el.clientWidth || !el.clientHeight) {\n pendingCreate = true\n return\n }\n pendingCreate = false\n\n // 卸载旧实例(主题切换时 theme 无法热替换,只能重建)\n chart.value?.dispose()\n\n const theme = props.themed ? resolveChartTheme()._echartsTheme : undefined\n\n /* echarts.init 会抛错(容器不是 DOM、已初始化过、canvas 创建失败等)。\n 之前没有保护:一个图表初始化失败会冒泡到全局,整页白屏。\n 现在捕获后走 onError 上报,组件降级为空态而不是崩掉。 */\n let instance\n try {\n instance = init(el, theme)\n } catch (err) {\n emit('error', err)\n return\n }\n chart.value = instance\n\n instance.on('click', (params: any) => emit('click', params))\n applyOption()\n emit('ready', instance)\n}\n\n/** 尺寸为 0 时挂起创建,等 ResizeObserver 通知 */\nlet pendingCreate = false\n\nfunction resize() {\n /* 之前因为尺寸为 0 而挂起的创建,在这里补上 */\n if (pendingCreate) {\n create()\n return\n }\n const instance = chart.value\n if (!instance || !container.value) return\n instance.resize()\n const rect = container.value.getBoundingClientRect()\n emit('resize', { width: rect.width, height: rect.height })\n}\n\nlet observer: ResizeObserver | null = null\n\nonMounted(async () => {\n registerFbkCharts()\n create()\n\n if (typeof ResizeObserver !== 'undefined' && container.value) {\n /* 用 ResizeObserver 而不是 window.resize:\n 图表在 flex / grid 容器里时,容器尺寸变化不会触发 window.resize,\n 图表会保持旧尺寸直到窗口变化 —— 这是\"图表不跟随布局\"的常见原因。 */\n observer = new ResizeObserver(() => resize())\n observer.observe(container.value)\n }\n\n /* 兜底:ResizeObserver 在元素尺寸从 0 变为非 0 时**必然**会触发一次,\n 但某些浏览器(或 jsdom)不保证。这里再补两帧检查,\n 确保挂起的创建一定会被执行。 */\n const ensure = (attempt = 0) => {\n if (!pendingCreate) return\n if (attempt > 10) return\n if (container.value?.clientHeight) {\n create()\n } else {\n requestAnimationFrame(() => ensure(attempt + 1))\n }\n }\n requestAnimationFrame(() => ensure())\n})\n\nonBeforeUnmount(() => {\n observer?.disconnect()\n observer = null\n chart.value?.dispose()\n chart.value = undefined\n})\n\n/* option 变化时更新。deep 是必须的:\n 业务侧常见写法是修改 series[0].data 而不换整个对象 */\nwatch(() => props.option, applyOption, { deep: true })\n\nwatch(\n () => props.loading,\n (loading) => {\n const instance = chart.value\n if (!instance) return\n if (loading) {\n instance.showLoading('default', {\n text: '加载中',\n color: 'var(--fbk-color-primary)',\n textColor: 'var(--fbk-color-text-secondary)',\n maskColor: 'transparent',\n })\n } else {\n instance.hideLoading()\n }\n },\n)\n\n/* 主题切换:监听根元素的 data-fbk-theme 属性 */\nlet themeObserver: MutationObserver | null = null\n\nonMounted(() => {\n if (typeof MutationObserver === 'undefined' || typeof document === 'undefined') return\n themeObserver = new MutationObserver((mutations) => {\n for (const m of mutations) {\n /* 只认 data-fbk-theme。\n 以前连 'class' 一起监听,于是 <html> 上任何 class 变化(字体、暗色兜底、\n 甚至别的库加的一个调试类)都会 dispose + init 一次:\n · 外部通过 getInstance() 拿到的句柄立刻变成已销毁实例\n · loading 遮罩与进行中的动画被重置\n 主题契约就是 data-fbk-theme(见 adapter-core/plugin.ts),class 不在契约里。 */\n if (m.attributeName === 'data-fbk-theme') {\n // 主题只能在 init 时指定,所以重建实例\n create()\n break\n }\n }\n })\n themeObserver.observe(document.documentElement, {\n attributes: true,\n attributeFilter: ['data-fbk-theme'],\n })\n})\n\nonBeforeUnmount(() => {\n themeObserver?.disconnect()\n themeObserver = null\n})\n\ndefineExpose({\n /** 底层 ECharts 实例,用于调用 dispatchAction 等高级能力 */\n getInstance: () => chart.value,\n resize,\n})\n</script>\n\n<template>\n <div class=\"fbk-chart\" v-bind=\"attrs\" :style=\"style\">\n <div\n v-show=\"!resolvedEmpty || loading\"\n ref=\"container\"\n class=\"fbk-chart__canvas\"\n :class=\"{ 'fbk-chart__canvas--loading': loading }\"\n />\n <div v-if=\"resolvedEmpty && !loading && emptyText\" class=\"fbk-chart__empty\">\n {{ emptyText }}\n </div>\n </div>\n</template>\n"],"names":["_createElementBlock","_mergeProps","_unref","_createElementVNode","_normalizeClass","_vShow","_toDisplayString"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"FbkChart.vue.mjs","sources":["../src/FbkChart.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, onMounted, ref, shallowRef, useAttrs, watch } from 'vue'\nimport { init, type ECharts } from 'echarts/core'\nimport { registerFbkCharts } from './register'\nimport { resolveOptionVars } from './color'\nimport { resolveChartTheme } from './theme'\nimport type { FbkChartOption } from './types'\n\n/**\n * option 里「可能整块出现 / 消失」的组件类型。\n *\n * 用来判断一次更新是**形状收缩**(某类组件整个不见了)还是**形状不变**(只换数据/系列)。\n * 只有前者需要放弃合并、整块重设 —— 见 applyOption 里的策略说明。\n *\n * 不含 series / legend:这两个用 replaceMerge 就能精确处理(系列变少、图例该消失),\n * 混进来只会让「单系列」这类正常变化被误判成形状收缩,白丢一次动画。\n * 也不含未注册的组件(register.ts 里没有 geo):它们不可能出现在 option 里。\n */\nconst SHAPE_COMPONENT_KEYS = [\n 'dataZoom',\n 'visualMap',\n 'xAxis',\n 'yAxis',\n 'grid',\n 'tooltip',\n 'polar',\n 'radar',\n 'angleAxis',\n 'radiusAxis',\n 'timeline',\n 'graphic',\n 'dataset',\n 'title',\n] as const\n\n/**\n * ECharts 容器组件。\n *\n * 职责边界(都是手写时最容易漏的):\n * · 生命周期:init / dispose,卸载时必须 dispose,否则实例泄漏\n * · 尺寸变化:ResizeObserver 而非 window.resize —— 容器在 flex/grid 里\n * 变化时 window 不会触发 resize,图表会保持旧尺寸\n * · 主题切换:监听 data-fbk-theme 变化并重新应用主题\n * · 空态:没有数据时不该渲染一个空白坐标系\n */\ndefineOptions({ name: 'FbkChart', inheritAttrs: false })\n\nconst props = withDefaults(\n defineProps<{\n /** ECharts option。类型刻意放宽,避免 echarts 类型进入公开契约 */\n option: FbkChartOption\n /** 高度,数字按 px 处理 */\n height?: string | number\n /** 是否显示加载态 */\n loading?: boolean\n /** 是否自动应用 FBK 主题 */\n themed?: boolean\n /** 空数据提示。传空字符串关闭空态 */\n emptyText?: string\n /** 空数据判定:默认检查 option.series 是否为空 */\n isEmpty?: boolean\n }>(),\n {\n height: undefined,\n loading: false,\n themed: true,\n emptyText: '暂无数据',\n isEmpty: undefined,\n },\n)\n\nconst emit = defineEmits<{\n ready: [chart: ECharts]\n click: [params: Record<string, any>]\n /** 尺寸变化(缩放后) */\n resize: [size: { width: number; height: number }]\n /**\n * 图表初始化或渲染失败。\n *\n * 不传时组件降级为空态,不抛到全局 —— 一个图表渲染失败\n * 不该让整页白屏。\n */\n error: [error: unknown]\n}>()\n\nconst container = ref<HTMLDivElement>()\nconst chart = shallowRef<ECharts>()\n/* 曾经有个 themeVersion ref 在这里,只写不读 —— 主题切换靠的是直接 create(),\n 那个计数器从来没参与任何逻辑。删掉,免得下一个人以为它是那条链路的开关。 */\n\n/* inheritAttrs: false 时必须手动转发 attrs,否则调用方的 class/style 会静默失效。\n attrs 落点是根 div:它既是 .fbk-chart(position: relative)的定位容器,\n 也是 position: absolute; inset: 0 的 canvas 的父级 —— 外部 style 只有落在这里才会影响布局。 */\nconst attrs = useAttrs()\n\nconst style = computed(() => {\n const h = props.height\n if (h === undefined) return {}\n return { height: typeof h === 'number' ? `${h}px` : h }\n})\n\n/** 默认空态判定:series 为空或所有系列都没有 data */\nconst resolvedEmpty = computed(() => {\n if (props.isEmpty !== undefined) return props.isEmpty\n const series = props.option?.series\n if (!series) return true\n const list = Array.isArray(series) ? series : [series]\n if (!list.length) return true\n return list.every((s: any) => !s?.data || (Array.isArray(s.data) && s.data.length === 0))\n})\n\n/**\n * 上一次更新之后,实例上存在哪些组件类型。\n *\n * 记账很简单:**永远等于上一次的 next**。因为只要 next 少了一类,\n * vanished 就成立、就走 notMerge 把实例清空重建 —— 也就是说\n * 「实例上有、但这次没给」这个状态根本不会留到下一次。\n * (曾经写成「合并后记并集」,那是不可达的分支:能出现并集差异的情形\n * 恰好就是 vanished 成立的情形。)\n */\nlet liveComponentKeys: Set<string> | undefined\n\nfunction applyOption() {\n const instance = chart.value\n if (!instance) return\n\n try {\n /* 必须先解析 CSS 变量:ECharts 用 Canvas 绘制,不认 var(--x),\n 直接传会抛 \"could not be parsed as a color\" 并且图表不上色。 */\n const resolved = resolveOptionVars(props.option)\n\n /* ---------- 合并策略:形状感知 ---------- */\n const nextKeys = new Set<string>(\n SHAPE_COMPONENT_KEYS.filter(\n (key) => (resolved as Record<string, unknown> | undefined)?.[key] !== undefined,\n ),\n )\n /* 「某类组件整个消失」是合并语义处理不了的情况:\n 新 option 里没有 dataZoom,合并会把它当成「别动」,于是旧缩放条永远留着\n (dz-demo.html 的 A 面板就是这个现象的对照演示)。\n\n 为什么不在 replaceMerge 里直接点名 dataZoom:\n 在 echarts 层实测它是正常的(SSR 里残留能清成 0),但在**大屏页面**里点名后\n 整页不渲染(CI 视觉回归 5 条 FAIL、本地 verify-charts 复现,回退即全绿),\n 根因未定位。所以这里绕开它:形状收缩的那一次改用 notMerge 整块重设,\n 代价只是这一次丢动画 —— 而形状收缩本来就是「换图型」,动画本来也要重来。 */\n const vanished = liveComponentKeys\n ? [...liveComponentKeys].some((key) => !nextKeys.has(key))\n : false\n\n /* 重建实例(主题切换)后遮罩会跟着旧实例一起没了,而 props.loading 没变、\n watcher 不会触发 —— 结果是「loading=true 却看不到遮罩」,看起来像加载完了。 */\n if (props.loading) {\n instance.showLoading('default', { text: '', color: '#3b82f6', maskColor: 'rgba(255,255,255,0.6)' })\n }\n\n instance.setOption(\n resolved as any,\n vanished\n ? { notMerge: true, lazyUpdate: false }\n : {\n /* 形状不变时走 replaceMerge:它精确处理「系列变少」与「图例该消失」,\n 其余组件照旧合并,因此动画和缩放位置都不会被重置。\n (纯合并 notMerge:false 做不到这两件事:系列会残留、图例移不掉。) */\n replaceMerge: ['series', 'legend'],\n lazyUpdate: false,\n },\n )\n\n liveComponentKeys = nextKeys\n } catch (err) {\n /* setOption 抛错通常是配置写错(渐变色的非法值、series 结构不对)。\n 捕获后上报,图表保留上一帧而不是整页崩。 */\n emit('error', err)\n }\n}\n\nfunction create() {\n const el = container.value\n if (!el) return\n\n /* 关键:ECharts 在 init 时会读取容器的 clientWidth/clientHeight 并**固定**下来。\n 如果此时容器高度是 0(flex / grid 布局里常见),它会写下\n `height: 0px` 的行内样式,之后 resize() 也无法恢复 —— 图表永久空白。\n\n 所以:容器没有高度时先不 init,等 ResizeObserver 报出有效尺寸再建。\n 这是大屏里\"图表全空白\"的真正原因。 */\n if (!el.clientWidth || !el.clientHeight) {\n pendingCreate = true\n return\n }\n pendingCreate = false\n\n // 卸载旧实例(主题切换时 theme 无法热替换,只能重建)\n chart.value?.dispose()\n\n const theme = props.themed ? resolveChartTheme()._echartsTheme : undefined\n\n /* echarts.init 会抛错(容器不是 DOM、已初始化过、canvas 创建失败等)。\n 之前没有保护:一个图表初始化失败会冒泡到全局,整页白屏。\n 现在捕获后走 onError 上报,组件降级为空态而不是崩掉。 */\n let instance\n try {\n instance = init(el, theme)\n } catch (err) {\n emit('error', err)\n return\n }\n chart.value = instance\n /* 新实例是空的,形状记账必须清零 —— 否则第一次 applyOption 会拿旧实例的并集\n 去判断「有没有组件消失」,可能凭空走一次 notMerge。 */\n liveComponentKeys = undefined\n\n instance.on('click', (params: any) => emit('click', params))\n applyOption()\n emit('ready', instance)\n}\n\n/** 尺寸为 0 时挂起创建,等 ResizeObserver 通知 */\nlet pendingCreate = false\n\nfunction resize() {\n /* 之前因为尺寸为 0 而挂起的创建,在这里补上 */\n if (pendingCreate) {\n create()\n return\n }\n const instance = chart.value\n if (!instance || !container.value) return\n instance.resize()\n const rect = container.value.getBoundingClientRect()\n emit('resize', { width: rect.width, height: rect.height })\n}\n\nlet observer: ResizeObserver | null = null\n\nonMounted(async () => {\n registerFbkCharts()\n create()\n\n if (typeof ResizeObserver !== 'undefined' && container.value) {\n /* 用 ResizeObserver 而不是 window.resize:\n 图表在 flex / grid 容器里时,容器尺寸变化不会触发 window.resize,\n 图表会保持旧尺寸直到窗口变化 —— 这是\"图表不跟随布局\"的常见原因。 */\n observer = new ResizeObserver(() => resize())\n observer.observe(container.value)\n }\n\n /* 兜底:ResizeObserver 在元素尺寸从 0 变为非 0 时**必然**会触发一次,\n 但某些浏览器(或 jsdom)不保证。这里再补两帧检查,\n 确保挂起的创建一定会被执行。 */\n const ensure = (attempt = 0) => {\n if (!pendingCreate) return\n if (attempt > 10) return\n if (container.value?.clientHeight) {\n create()\n } else {\n requestAnimationFrame(() => ensure(attempt + 1))\n }\n }\n requestAnimationFrame(() => ensure())\n})\n\nonBeforeUnmount(() => {\n observer?.disconnect()\n observer = null\n chart.value?.dispose()\n chart.value = undefined\n})\n\n/* option 变化时更新。deep 是必须的:\n 业务侧常见写法是修改 series[0].data 而不换整个对象 */\nwatch(() => props.option, applyOption, { deep: true })\n\nwatch(\n () => props.loading,\n (loading) => {\n const instance = chart.value\n if (!instance) return\n if (loading) {\n instance.showLoading('default', {\n text: '加载中',\n color: 'var(--fbk-color-primary)',\n textColor: 'var(--fbk-color-text-secondary)',\n maskColor: 'transparent',\n })\n } else {\n instance.hideLoading()\n }\n },\n)\n\n/* 主题切换:监听根元素的 data-fbk-theme 属性 */\nlet themeObserver: MutationObserver | null = null\n\nonMounted(() => {\n if (typeof MutationObserver === 'undefined' || typeof document === 'undefined') return\n themeObserver = new MutationObserver((mutations) => {\n for (const m of mutations) {\n /* 只认 data-fbk-theme。\n 以前连 'class' 一起监听,于是 <html> 上任何 class 变化(字体、暗色兜底、\n 甚至别的库加的一个调试类)都会 dispose + init 一次:\n · 外部通过 getInstance() 拿到的句柄立刻变成已销毁实例\n · loading 遮罩与进行中的动画被重置\n 主题契约就是 data-fbk-theme(见 adapter-core/plugin.ts),class 不在契约里。 */\n if (m.attributeName === 'data-fbk-theme') {\n // 主题只能在 init 时指定,所以重建实例\n create()\n break\n }\n }\n })\n themeObserver.observe(document.documentElement, {\n attributes: true,\n attributeFilter: ['data-fbk-theme'],\n })\n})\n\nonBeforeUnmount(() => {\n themeObserver?.disconnect()\n themeObserver = null\n})\n\ndefineExpose({\n /** 底层 ECharts 实例,用于调用 dispatchAction 等高级能力 */\n getInstance: () => chart.value,\n resize,\n})\n</script>\n\n<template>\n <div class=\"fbk-chart\" v-bind=\"attrs\" :style=\"style\">\n <div\n v-show=\"!resolvedEmpty || loading\"\n ref=\"container\"\n class=\"fbk-chart__canvas\"\n :class=\"{ 'fbk-chart__canvas--loading': loading }\"\n />\n <div v-if=\"resolvedEmpty && !loading && emptyText\" class=\"fbk-chart__empty\">\n {{ emptyText }}\n </div>\n </div>\n</template>\n"],"names":["_createElementBlock","_mergeProps","_unref","_createElementVNode","_normalizeClass","_vShow","_toDisplayString"],"mappings":"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"}
|