@fbkworks/chart-core 0.7.0 → 0.8.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 +50 -21
- package/dist/FbkChart.vue.mjs.map +1 -1
- package/dist/register.mjs +1 -1
- package/dist/register.mjs.map +1 -1
- package/dist/types.d.ts +9 -1
- package/package.json +1 -1
package/dist/FbkChart.vue.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { defineComponent, ref, shallowRef, useAttrs, computed, onMounted, onBeforeUnmount, watch, openBlock, createElementBlock, mergeProps, unref, withDirectives, createElementVNode, normalizeClass, vShow, toDisplayString, createCommentVNode } from "vue";
|
|
2
2
|
import { init } from "echarts/core";
|
|
3
3
|
import { registerFbkCharts } from "./register.mjs";
|
|
4
|
-
import { resolveOptionVars } from "./color.mjs";
|
|
4
|
+
import { resolveOptionVars, resolveCssValue } from "./color.mjs";
|
|
5
5
|
import { resolveChartTheme } from "./theme.mjs";
|
|
6
6
|
const _hoisted_1 = {
|
|
7
7
|
key: 0,
|
|
@@ -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,44 @@ 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;
|
|
58
|
+
function loadingOptions() {
|
|
59
|
+
const cssColor = (name, fallback) => {
|
|
60
|
+
const resolved = resolveCssValue("var(" + name + ")");
|
|
61
|
+
return resolved.includes("var(") ? fallback : resolved;
|
|
62
|
+
};
|
|
63
|
+
return {
|
|
64
|
+
text: "加载中",
|
|
65
|
+
color: cssColor("--fbk-color-primary", "#3b82f6"),
|
|
66
|
+
textColor: cssColor("--fbk-color-text-secondary", "#5c6370"),
|
|
67
|
+
maskColor: "rgba(255,255,255,0.6)"
|
|
68
|
+
};
|
|
69
|
+
}
|
|
41
70
|
function applyOption() {
|
|
42
71
|
const instance = chart.value;
|
|
43
72
|
if (!instance) return;
|
|
44
73
|
try {
|
|
45
74
|
const resolved = resolveOptionVars(props.option);
|
|
75
|
+
const nextKeys = new Set(
|
|
76
|
+
SHAPE_COMPONENT_KEYS.filter(
|
|
77
|
+
(key) => resolved?.[key] !== void 0
|
|
78
|
+
)
|
|
79
|
+
);
|
|
80
|
+
const vanished = liveComponentKeys ? [...liveComponentKeys].some((key) => !nextKeys.has(key)) : false;
|
|
46
81
|
if (props.loading) {
|
|
47
|
-
instance.showLoading("default",
|
|
82
|
+
instance.showLoading("default", loadingOptions());
|
|
48
83
|
}
|
|
49
|
-
instance.setOption(
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
lazyUpdate: false
|
|
61
|
-
});
|
|
84
|
+
instance.setOption(
|
|
85
|
+
resolved,
|
|
86
|
+
vanished ? { notMerge: true, lazyUpdate: false } : {
|
|
87
|
+
/* 形状不变时走 replaceMerge:它精确处理「系列变少」与「图例该消失」,
|
|
88
|
+
其余组件照旧合并,因此动画和缩放位置都不会被重置。
|
|
89
|
+
(纯合并 notMerge:false 做不到这两件事:系列会残留、图例移不掉。) */
|
|
90
|
+
replaceMerge: ["series", "legend"],
|
|
91
|
+
lazyUpdate: false
|
|
92
|
+
}
|
|
93
|
+
);
|
|
94
|
+
liveComponentKeys = nextKeys;
|
|
62
95
|
} catch (err) {
|
|
63
96
|
emit("error", err);
|
|
64
97
|
}
|
|
@@ -81,6 +114,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
81
114
|
return;
|
|
82
115
|
}
|
|
83
116
|
chart.value = instance;
|
|
117
|
+
liveComponentKeys = void 0;
|
|
84
118
|
instance.on("click", (params) => emit("click", params));
|
|
85
119
|
applyOption();
|
|
86
120
|
emit("ready", instance);
|
|
@@ -129,12 +163,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
|
|
|
129
163
|
const instance = chart.value;
|
|
130
164
|
if (!instance) return;
|
|
131
165
|
if (loading) {
|
|
132
|
-
instance.showLoading("default",
|
|
133
|
-
text: "加载中",
|
|
134
|
-
color: "var(--fbk-color-primary)",
|
|
135
|
-
textColor: "var(--fbk-color-text-secondary)",
|
|
136
|
-
maskColor: "transparent"
|
|
137
|
-
});
|
|
166
|
+
instance.showLoading("default", loadingOptions());
|
|
138
167
|
} else {
|
|
139
168
|
instance.hideLoading();
|
|
140
169
|
}
|
|
@@ -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 { resolveCssValue, 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\n/**\n * 加载遮罩的**唯一**配置。\n *\n * 以前有两份互不相同的:挂载路径那份是「60% 白纱 + 无文案」,\n * loading watcher 那份是「透明遮罩 + 加载中」。同一个 loading 状态,\n * 首屏挂着进来走前者、之后切换走后者 —— 同屏两种外观,\n * 暗色/cyber 大屏上那份白纱还会整块闪一下。\n *\n * 颜色必须落到字面值:ECharts 用 Canvas 绘制,不认 var(--x)。\n * 直接传 var 字符串会把 strokeStyle 赋成非法值(canvas 保留上一次的颜色、SVG 不描边),\n * 而代码看起来完全正常 —— 转圈不是品牌色,深色主题下几乎看不见。\n */\nfunction loadingOptions(): Record<string, unknown> {\n const cssColor = (name: string, fallback: string) => {\n const resolved = resolveCssValue(\"var(\" + name + \")\")\n return resolved.includes(\"var(\") ? fallback : resolved\n }\n return {\n text: \"加载中\",\n color: cssColor(\"--fbk-color-primary\", \"#3b82f6\"),\n textColor: cssColor(\"--fbk-color-text-secondary\", \"#5c6370\"),\n maskColor: \"rgba(255,255,255,0.6)\",\n }\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\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', loadingOptions())\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', loadingOptions())\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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"}
|
package/dist/register.mjs
CHANGED
|
@@ -25,7 +25,7 @@ const COMPONENT_MAP = {
|
|
|
25
25
|
visualMap: VisualMapComponent,
|
|
26
26
|
dataZoom: DataZoomComponent
|
|
27
27
|
};
|
|
28
|
-
const DEFAULT_CHARTS =
|
|
28
|
+
const DEFAULT_CHARTS = Object.keys(CHART_MAP);
|
|
29
29
|
const DEFAULT_COMPONENTS = [
|
|
30
30
|
"grid",
|
|
31
31
|
"tooltip",
|
package/dist/register.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"register.mjs","sources":["../src/register.ts"],"sourcesContent":["import * as echarts from 'echarts/core'\nimport {\n BarChart,\n FunnelChart,\n GaugeChart,\n LineChart,\n PieChart,\n RadarChart,\n ScatterChart,\n} from 'echarts/charts'\nimport {\n DataZoomComponent,\n DatasetComponent,\n GraphicComponent,\n GridComponent,\n LegendComponent,\n MarkLineComponent,\n MarkPointComponent,\n TitleComponent,\n TooltipComponent,\n TransformComponent,\n VisualMapComponent,\n} from 'echarts/components'\nimport { CanvasRenderer } from 'echarts/renderers'\nimport { warnOnce } from '@fbkworks/shared'\nimport type { FbkChartType, RegisterChartsOptions } from './types'\n\n/**\n * ECharts 按需注册。\n *\n * 为什么需要:ECharts 全量约 1MB(gzip ~330KB)。大屏能接受,\n * 但嵌入后台的数据看板不该为此付出代价。\n *\n * **为什么用同步静态导入而不是动态 import**:\n * 图表必须在组件渲染前完成注册,异步注册会导致首屏空白一帧。\n * 静态导入让打包器能静态分析、只打包用到的模块。\n *\n * 代价:即使业务方只用折线图,未使用的图表模块也在包里。\n * 要极致瘦身应改用 `echarts/core` 手动注册(文档里说明)。\n */\n\nconst CHART_MAP = {\n line: LineChart,\n bar: BarChart,\n pie: PieChart,\n gauge: GaugeChart,\n scatter: ScatterChart,\n radar: RadarChart,\n funnel: FunnelChart,\n} as const\n\nconst COMPONENT_MAP = {\n grid: GridComponent,\n tooltip: TooltipComponent,\n legend: LegendComponent,\n title: TitleComponent,\n dataset: DatasetComponent,\n transform: TransformComponent,\n markLine: MarkLineComponent,\n markPoint: MarkPointComponent,\n graphic: GraphicComponent,\n visualMap: VisualMapComponent,\n dataZoom: DataZoomComponent,\n} as const\n\
|
|
1
|
+
{"version":3,"file":"register.mjs","sources":["../src/register.ts"],"sourcesContent":["import * as echarts from 'echarts/core'\nimport {\n BarChart,\n FunnelChart,\n GaugeChart,\n LineChart,\n PieChart,\n RadarChart,\n ScatterChart,\n} from 'echarts/charts'\nimport {\n DataZoomComponent,\n DatasetComponent,\n GraphicComponent,\n GridComponent,\n LegendComponent,\n MarkLineComponent,\n MarkPointComponent,\n TitleComponent,\n TooltipComponent,\n TransformComponent,\n VisualMapComponent,\n} from 'echarts/components'\nimport { CanvasRenderer } from 'echarts/renderers'\nimport { warnOnce } from '@fbkworks/shared'\nimport type { FbkChartType, RegisterChartsOptions } from './types'\n\n/**\n * ECharts 按需注册。\n *\n * 为什么需要:ECharts 全量约 1MB(gzip ~330KB)。大屏能接受,\n * 但嵌入后台的数据看板不该为此付出代价。\n *\n * **为什么用同步静态导入而不是动态 import**:\n * 图表必须在组件渲染前完成注册,异步注册会导致首屏空白一帧。\n * 静态导入让打包器能静态分析、只打包用到的模块。\n *\n * 代价:即使业务方只用折线图,未使用的图表模块也在包里。\n * 要极致瘦身应改用 `echarts/core` 手动注册(文档里说明)。\n */\n\nconst CHART_MAP = {\n line: LineChart,\n bar: BarChart,\n pie: PieChart,\n gauge: GaugeChart,\n scatter: ScatterChart,\n radar: RadarChart,\n funnel: FunnelChart,\n} as const\n\nconst COMPONENT_MAP = {\n grid: GridComponent,\n tooltip: TooltipComponent,\n legend: LegendComponent,\n title: TitleComponent,\n dataset: DatasetComponent,\n transform: TransformComponent,\n markLine: MarkLineComponent,\n markPoint: MarkPointComponent,\n graphic: GraphicComponent,\n visualMap: VisualMapComponent,\n dataZoom: DataZoomComponent,\n} as const\n\n/**\n * 默认注册的图表类型 = CHART_MAP 的全部键。\n *\n * 以前写死 4 个(line/bar/pie/gauge),而公开类型 FbkChartType 承诺 8 种、\n * FbkChart 又是**无参数**调用 —— scatter / radar / funnel 的用户拿到\n * 「有坐标轴、没有任何系列、也不显示空态」的空图表:echarts 只打一行\n * \"Series scatter is used but not imported\",不抛错,所以 try/catch 抓不到、\n * emit('error') 也不触发。\n *\n * 从 CHART_MAP 推导而不是再抄一份:抄的清单迟早和类型联合不一致。\n */\nconst DEFAULT_CHARTS = Object.keys(CHART_MAP) as FbkChartType[]\nconst DEFAULT_COMPONENTS = [\n 'grid',\n 'tooltip',\n 'legend',\n 'title',\n 'dataset',\n 'markLine',\n 'markPoint',\n 'graphic',\n] as const\n\nlet registered = false\nconst doneCharts = new Set<string>()\nconst doneComponents = new Set<string>()\n\n/**\n * 注册图表能力。可多次调用,只注册尚未注册的部分。\n *\n * ```ts\n * // 默认:折线 / 柱状 / 饼 / 仪表盘 + 常用组件\n * registerFbkCharts()\n *\n * // 按需:只要折线\n * registerFbkCharts({ charts: ['line'], components: ['grid', 'tooltip'] })\n * ```\n */\nexport function registerFbkCharts(options: RegisterChartsOptions = {}): void {\n const charts = (options.charts ?? DEFAULT_CHARTS) as FbkChartType[]\n const components = options.components ?? (DEFAULT_COMPONENTS as unknown as string[])\n\n const pendingCharts = charts.filter((c) => !doneCharts.has(c))\n const pendingComponents = components.filter((c) => !doneComponents.has(c))\n\n if (!pendingCharts.length && !pendingComponents.length) return\n\n // FbkChartType / FbkChartComponent 比映射表宽('map' / 'geo' / 'toolbox' 尚无实现)。\n // 类型能过、ECharts 侧却没东西可用 —— 只把真正注册成功的项标记为完成,\n // 否则未登记项会被当成\"已注册\",既不重试也没有任何线索。\n const resolvedCharts = pendingCharts.filter((c) => {\n if ((CHART_MAP as Record<string, any>)[c]) return true\n warnOnce(\n `chart:unresolved:chart:${c}`,\n `图表类型 \"${c}\" 尚未在 @fbkworks/chart-core 中实现,已跳过注册(该类型的图表会空白)。`,\n )\n return false\n })\n const resolvedComponents = pendingComponents.filter((c) => {\n if ((COMPONENT_MAP as Record<string, any>)[c]) return true\n warnOnce(\n `chart:unresolved:component:${c}`,\n `图表组件 \"${c}\" 尚未在 @fbkworks/chart-core 中实现,已跳过注册(依赖它的图表会空白)。`,\n )\n return false\n })\n\n if (!resolvedCharts.length && !resolvedComponents.length) return\n\n echarts.use([\n ...resolvedCharts.map((c) => (CHART_MAP as Record<string, any>)[c]),\n ...resolvedComponents.map((c) => (COMPONENT_MAP as Record<string, any>)[c]),\n CanvasRenderer,\n ])\n\n resolvedCharts.forEach((c) => doneCharts.add(c))\n resolvedComponents.forEach((c) => doneComponents.add(c))\n registered = true\n}\n\n/** 是否已完成注册(测试与调试用) */\nexport function isFbkChartsRegistered(): boolean {\n return registered\n}\n\n/** 测试用:重置注册状态。注意 echarts 内部注册表无法真正撤销 */\nexport function __resetChartRegistration(): void {\n registered = false\n doneCharts.clear()\n doneComponents.clear()\n}\n"],"names":[],"mappings":";;;;;AAyCA,MAAM,YAAY;AAAA,EAChB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,KAAK;AAAA,EACL,OAAO;AAAA,EACP,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AACV;AAEA,MAAM,gBAAgB;AAAA,EACpB,MAAM;AAAA,EACN,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AAAA,EACX,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AACZ;AAaA,MAAM,iBAAiB,OAAO,KAAK,SAAS;AAC5C,MAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAI,aAAa;AACjB,MAAM,iCAAiB,IAAA;AACvB,MAAM,qCAAqB,IAAA;AAapB,SAAS,kBAAkB,UAAiC,IAAU;AAC3E,QAAM,SAAU,QAAQ,UAAU;AAClC,QAAM,aAAa,QAAQ,cAAe;AAE1C,QAAM,gBAAgB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;AAC7D,QAAM,oBAAoB,WAAW,OAAO,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;AAEzE,MAAI,CAAC,cAAc,UAAU,CAAC,kBAAkB,OAAQ;AAKxD,QAAM,iBAAiB,cAAc,OAAO,CAAC,MAAM;AACjD,QAAK,UAAkC,CAAC,EAAG,QAAO;AAClD;AAAA,MACE,0BAA0B,CAAC;AAAA,MAC3B,SAAS,CAAC;AAAA,IAAA;AAEZ,WAAO;AAAA,EACT,CAAC;AACD,QAAM,qBAAqB,kBAAkB,OAAO,CAAC,MAAM;AACzD,QAAK,cAAsC,CAAC,EAAG,QAAO;AACtD;AAAA,MACE,8BAA8B,CAAC;AAAA,MAC/B,SAAS,CAAC;AAAA,IAAA;AAEZ,WAAO;AAAA,EACT,CAAC;AAED,MAAI,CAAC,eAAe,UAAU,CAAC,mBAAmB,OAAQ;AAE1D,UAAQ,IAAI;AAAA,IACV,GAAG,eAAe,IAAI,CAAC,MAAO,UAAkC,CAAC,CAAC;AAAA,IAClE,GAAG,mBAAmB,IAAI,CAAC,MAAO,cAAsC,CAAC,CAAC;AAAA,IAC1E;AAAA,EAAA,CACD;AAED,iBAAe,QAAQ,CAAC,MAAM,WAAW,IAAI,CAAC,CAAC;AAC/C,qBAAmB,QAAQ,CAAC,MAAM,eAAe,IAAI,CAAC,CAAC;AACvD,eAAa;AACf;AAGO,SAAS,wBAAiC;AAC/C,SAAO;AACT;"}
|
package/dist/types.d.ts
CHANGED
|
@@ -10,7 +10,15 @@ import { EChartsOption } from 'echarts';
|
|
|
10
10
|
/** 对外暴露的 option 类型。刻意放宽,避免把 echarts 的类型绑进公开契约 */
|
|
11
11
|
export type FbkChartOption = Record<string, any>;
|
|
12
12
|
/** 图表类型(按需注册用) */
|
|
13
|
-
|
|
13
|
+
/**
|
|
14
|
+
* 可用的图表类型。
|
|
15
|
+
*
|
|
16
|
+
* 这里**必须**与 register.ts 的 CHART_MAP 一一对应 —— 类型比映射表宽的那种情况
|
|
17
|
+
* (原来多一个 'map')意味着「类型上允许、注册时被静默丢弃」:
|
|
18
|
+
* echarts 的 map 还需要业务方提供 GeoJSON(registerMap),本库没有这个入口,
|
|
19
|
+
* 与其留一个假装支持的联合成员,不如删掉。
|
|
20
|
+
*/
|
|
21
|
+
export type FbkChartType = 'line' | 'bar' | 'pie' | 'gauge' | 'scatter' | 'radar' | 'funnel';
|
|
14
22
|
/** ECharts 组件(按需注册用) */
|
|
15
23
|
export type FbkChartComponent = 'grid' | 'tooltip' | 'legend' | 'title' | 'dataset' | 'transform' | 'markLine' | 'markPoint' | 'graphic' | 'geo' | 'visualMap' | 'dataZoom' | 'toolbox';
|
|
16
24
|
export interface RegisterChartsOptions {
|