FCS 组件库开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_081bcff4/fcs-widget-dev
技能介绍
需要解决的问题
在 FCS 组件库中开发新的页面部件时,有几个反复出现的痛点:
- 自适应布局难以精确控制:直接写像素值在高分辨率屏上错位,百分比计算稍有偏差就会让底部溢出、出现滚动条。
noPanel: true行为不直观:框架不再包裹FcsPanel后,x/y定位仍然生效,但w/h可能被忽略,组件会撑满父容器。- 跨 widget 引用源码路径容易算错:从一个 widget 的
src/index.vue引用另一个 widget 的组件,目录层级容易少退一层。 - ECharts 热更新不刷新:把
initChart()塞进onMounted后,HMR 不会重新触发,改了代码图表却不变。 - 数字字体中文回退难看:使用
$fcs-font-family-number时,fallback 为 monospace,页面一旦出现中文数字,排版就会崩。
技能如何工作
本指南围绕上述痛点展开,给出了一套可落地的工程规范。
组件文件结构:每个 FCS 组件由 index.js、config.js 和 settings 三个文件组成。settings 支持三种输入类型——SIT.INPUT(文本)、SIT.SWITCH(开关)、SIT.SELECT(下拉),均从 zgis-common 的 Rule.SettingInputType 引入。组件需要手动注册到 src/widgets/fcs/index.js。
Grid 定位计算:以 1920×1080 设计稿为基准,通过百分比实现自适应。核心规则是 h 必须等于 100 - y,例如 y: '8.33' 对应 h: '91.67',否则底部溢出产生滚动条。
noPanel 宽度约束:使用 noPanel: true 时降级方案是在组件内部包一层 content-wrapper div,用 CSS 显式控制宽度,防止组件撑满容器。
跨 widget 导入:从当前 widget 引用其他 widget 的源文件,路径需要退两层 ../../,再进入目标 widget 的 src/index.vue。
ECharts 集成:图表初始化放在组件顶层而非 onMounted,并用 ResizeObserver 监听容器尺寸变化,而非 window.resize事件,这样 HMR 重载后图表也能正确渲染。
字体规范:面板大标题使用 $fcs-font-family-title(钉钉金布体),章节小标题与正文使用 $fcs-font-family-body(Alibaba PuHuiTi 2.0),数字直接写 'D-DIN', sans-serif,不走有问题的 $fcs-font-family-number 变量。
适用边界与注意点
noPanel: true时fix/responsive模式可能不生效,建议统一使用 grid 模式。- 每个
flex: 1容器必须搭配min-height: 0,否则 flex 子项不会主动收缩。 - 渐变边框需用
::before伪元素加mask-composite: xor模拟,border-image不支持圆角。 border: 1px、border-radius: 9999px和图标固定尺寸场景应保留 px 单位。
使用场景
- 在FCS组件库中新建页面widget,需要确定`index.js`、`config.js`、`settings`三个文件的结构和注册位置
- 用grid模式做自适应布局,需要计算`y`和`h`的百分比避免底部溢出滚动条
- 集成ECharts图表到widget,需要把`initChart`放在组件顶层并配置`ResizeObserver`适配容器变化
- 修复`noPanel`组件宽度撑满容器的问题,需要添加`content-wrapper`并写CSS约束宽度
适合人员
- FCS组件库的前端开发工程师,需要按规范创建新widget并注册到组件库
- 负责FCS大屏页面布局的工程师,需要用grid模式实现自适应且避免滚动条溢出
- 维护FCS图表组件的开发者,需要解决ECharts热更新不刷新和容器自适应问题
- 处理FCS组件样式的前端,需要规范字体使用并避免数字中文回退问题