@fbkworks/chart-core 0.6.0 → 0.7.0
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 +12 -0
- package/dist/FbkChart.vue.mjs.map +1 -1
- package/package.json +1 -1
package/dist/FbkChart.vue.mjs
CHANGED
|
@@ -43,7 +43,19 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
43
43
|
if (!instance) return;
|
|
44
44
|
try {
|
|
45
45
|
const resolved = resolveOptionVars(props.option);
|
|
46
|
+
if (props.loading) {
|
|
47
|
+
instance.showLoading("default", { text: "", color: "#3b82f6", maskColor: "rgba(255,255,255,0.6)" });
|
|
48
|
+
}
|
|
46
49
|
instance.setOption(resolved, {
|
|
50
|
+
/* 只替换「可能整块消失」的组件类型。
|
|
51
|
+
实测:series / legend / dataZoom 在新 option 里被删掉后,
|
|
52
|
+
纯合并会把它们留在实例上(折线↔饼这类换图型会留下空坐标系与残留缩放条)。
|
|
53
|
+
xAxis / yAxis / grid 不在这里 —— 它们的增减在合并语义下能正确归一
|
|
54
|
+
(实测轴互换后 axisLabel 的 width/overflow 被丢弃、axisLine.show 归一),
|
|
55
|
+
换成 replaceMerge 反而会让坐标轴动画每帧重建。 */
|
|
56
|
+
/* 只能点名**已注册**的组件。register.ts 里没有 geo,
|
|
57
|
+
点名它会直接让 echarts 崩掉(大屏整页图表消失,CI 的视觉回归当场红)——
|
|
58
|
+
没注册的组件本来也不可能出现在 option 里,不必也不该列进来。 */
|
|
47
59
|
replaceMerge: ["series", "legend"],
|
|
48
60
|
lazyUpdate: false
|
|
49
61
|
});
|
|
@@ -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 instance.setOption(resolved as any, {\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":";;;;;;;;;;;;;;;;;;;;;;AAoBA,UAAM,QAAQ;AAwBd,UAAM,OAAO;AAcb,UAAM,YAAY,IAAA;AAClB,UAAM,QAAQ,WAAA;AAOd,UAAM,QAAQ,SAAA;AAEd,UAAM,QAAQ,SAAS,MAAM;AAC3B,YAAM,IAAI,MAAM;AAChB,UAAI,MAAM,OAAW,QAAO,CAAA;AAC5B,aAAO,EAAE,QAAQ,OAAO,MAAM,WAAW,GAAG,CAAC,OAAO,EAAA;AAAA,IACtD,CAAC;AAGD,UAAM,gBAAgB,SAAS,MAAM;AACnC,UAAI,MAAM,YAAY,OAAW,QAAO,MAAM;AAC9C,YAAM,SAAS,MAAM,QAAQ;AAC7B,UAAI,CAAC,OAAQ,QAAO;AACpB,YAAM,OAAO,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM;AACrD,UAAI,CAAC,KAAK,OAAQ,QAAO;AACzB,aAAO,KAAK,MAAM,CAAC,MAAW,CAAC,GAAG,QAAS,MAAM,QAAQ,EAAE,IAAI,KAAK,EAAE,KAAK,WAAW,CAAE;AAAA,IAC1F,CAAC;AAED,aAAS,cAAc;AACrB,YAAM,WAAW,MAAM;AACvB,UAAI,CAAC,SAAU;AAEf,UAAI;AAGF,cAAM,WAAW,kBAAkB,MAAM,MAAM;AAQ/C,iBAAS,UAAU,UAAiB;AAAA,UAClC,cAAc,CAAC,UAAU,QAAQ;AAAA,UACjC,YAAY;AAAA,QAAA,CACb;AAAA,MACH,SAAS,KAAK;AAGZ,aAAK,SAAS,GAAG;AAAA,MACnB;AAAA,IACF;AAEA,aAAS,SAAS;AAChB,YAAM,KAAK,UAAU;AACrB,UAAI,CAAC,GAAI;AAQT,UAAI,CAAC,GAAG,eAAe,CAAC,GAAG,cAAc;AACvC,wBAAgB;AAChB;AAAA,MACF;AACA,sBAAgB;AAGhB,YAAM,OAAO,QAAA;AAEb,YAAM,QAAQ,MAAM,SAAS,kBAAA,EAAoB,gBAAgB;AAKjE,UAAI;AACJ,UAAI;AACF,mBAAW,KAAK,IAAI,KAAK;AAAA,MAC3B,SAAS,KAAK;AACZ,aAAK,SAAS,GAAG;AACjB;AAAA,MACF;AACA,YAAM,QAAQ;AAEd,eAAS,GAAG,SAAS,CAAC,WAAgB,KAAK,SAAS,MAAM,CAAC;AAC3D,kBAAA;AACA,WAAK,SAAS,QAAQ;AAAA,IACxB;AAGA,QAAI,gBAAgB;AAEpB,aAAS,SAAS;AAEhB,UAAI,eAAe;AACjB,eAAA;AACA;AAAA,MACF;AACA,YAAM,WAAW,MAAM;AACvB,UAAI,CAAC,YAAY,CAAC,UAAU,MAAO;AACnC,eAAS,OAAA;AACT,YAAM,OAAO,UAAU,MAAM,sBAAA;AAC7B,WAAK,UAAU,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ;AAAA,IAC3D;AAEA,QAAI,WAAkC;AAEtC,cAAU,YAAY;AACpB,wBAAA;AACA,aAAA;AAEA,UAAI,OAAO,mBAAmB,eAAe,UAAU,OAAO;AAI5D,mBAAW,IAAI,eAAe,MAAM,QAAQ;AAC5C,iBAAS,QAAQ,UAAU,KAAK;AAAA,MAClC;AAKA,YAAM,SAAS,CAAC,UAAU,MAAM;AAC9B,YAAI,CAAC,cAAe;AACpB,YAAI,UAAU,GAAI;AAClB,YAAI,UAAU,OAAO,cAAc;AACjC,iBAAA;AAAA,QACF,OAAO;AACL,gCAAsB,MAAM,OAAO,UAAU,CAAC,CAAC;AAAA,QACjD;AAAA,MACF;AACA,4BAAsB,MAAM,QAAQ;AAAA,IACtC,CAAC;AAED,oBAAgB,MAAM;AACpB,gBAAU,WAAA;AACV,iBAAW;AACX,YAAM,OAAO,QAAA;AACb,YAAM,QAAQ;AAAA,IAChB,CAAC;AAID,UAAM,MAAM,MAAM,QAAQ,aAAa,EAAE,MAAM,MAAM;AAErD;AAAA,MACE,MAAM,MAAM;AAAA,MACZ,CAAC,YAAY;AACX,cAAM,WAAW,MAAM;AACvB,YAAI,CAAC,SAAU;AACf,YAAI,SAAS;AACX,mBAAS,YAAY,WAAW;AAAA,YAC9B,MAAM;AAAA,YACN,OAAO;AAAA,YACP,WAAW;AAAA,YACX,WAAW;AAAA,UAAA,CACZ;AAAA,QACH,OAAO;AACL,mBAAS,YAAA;AAAA,QACX;AAAA,MACF;AAAA,IAAA;AAIF,QAAI,gBAAyC;AAE7C,cAAU,MAAM;AACd,UAAI,OAAO,qBAAqB,eAAe,OAAO,aAAa,YAAa;AAChF,sBAAgB,IAAI,iBAAiB,CAAC,cAAc;AAClD,mBAAW,KAAK,WAAW;AAOzB,cAAI,EAAE,kBAAkB,kBAAkB;AAExC,mBAAA;AACA;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AACD,oBAAc,QAAQ,SAAS,iBAAiB;AAAA,QAC9C,YAAY;AAAA,QACZ,iBAAiB,CAAC,gBAAgB;AAAA,MAAA,CACnC;AAAA,IACH,CAAC;AAED,oBAAgB,MAAM;AACpB,qBAAe,WAAA;AACf,sBAAgB;AAAA,IAClB,CAAC;AAED,aAAa;AAAA;AAAA,MAEX,aAAa,MAAM,MAAM;AAAA,MACzB;AAAA,IAAA,CACD;;0BAICA,mBAUM,OAVNC,WAUM,EAVD,OAAM,YAAA,GAAoBC,MAAA,KAAA,GAAK,EAAG,OAAO,MAAA,MAAA,CAAK,GAAA;AAAA,uBACjDC,mBAKE,OAAA;AAAA,mBAHI;AAAA,UAAJ,KAAI;AAAA,UACJ,OAAKC,eAAA,CAAC,qBAAmB,EAAA,8BACe,QAAA,SAAO,CAAA;AAAA,QAAA;UAHtC,CAAAC,OAAA,CAAA,cAAA,SAAiB,QAAA,OAAO;AAAA,QAAA;QAKxB,cAAA,SAAa,CAAK,QAAA,WAAW,QAAA,0BAAxCL,mBAEM,OAFN,YAEMM,gBADD,QAAA,SAAS,GAAA,CAAA;;;;;"}
|
|
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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"}
|