Agent Skills
返回列表
💻

FCS 组件库开发

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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组件样式的前端,需要规范字体使用并避免数字中文回退问题