4.7 KiB
4.7 KiB
主题 / UI 组件库 / i18n / 导出
主题
- 唯一真相
fms-vue/src/theme/tokens.css::root浅色 +.dark深色必须同步增删同名变量,--fms-primary由 JS 写入,衍生色用color-mix()。改主题只动这个文件。 - 侧栏当前是浅色的(不存在
--fms-sidebar-*变量;若再看到「侧栏是黑的」即为过期信息)。 要改侧栏配色就新增--fms-sidebar-*只给AppSidebar.vue/NavMenuItem.vue用, 别动--fms-surface/--fms-text等全局中性色(顶栏与所有业务页共用)。 - 深底 + 主题色高亮必须用「深底 + 白字 + 主色亮描边」:填充
color-mix(primary 38%, #000)、 描边color-mix(primary 40%, #fff);「浅底 + 白字」对比度只有 1.4~2.7:1,不可用。 - Teleport 到 body 的浮层(如
.fms-team-menu-*)不在侧栏内,保持全局浅色 token。
UI 组件库全局配置
- 唯一入口
fms-vue/src/components/ui/config.js:uiConfig(reactive)+setUIConfig(patch)(按组件维度浅合并)+resetUIConfig(),也从@/components/ui具名导出。 没有 ConfigProvider、没有 app.use 插件。 - 回落顺序固定 自身 prop > uiConfig > 组件内置默认;要支持全局覆盖的 prop,
default必须写undefined且 validator 要放行undefined(Vue 会拿 default 跑校验)。 - Form 的
layout/labelAlign/labelWidth/validateTrigger已接入;provide 下发回落后的最终值。 语言联动在src/App.vue:中文horizontal、其他语言vertical(判定/^zh/i)。 - 多列紧凑网格的表单必须显式
layout="vertical"(如自动编码面板 columns=5), 否则横排的 88px 标签会把控件压到几十像素。prop 优先于全局配置。 defineModel写完不能立刻回读:写了只 emit,prop 下一轮才回来;要取刚写入的值就自己先reactive()包一层再赋值,返回其中的代理对象。
i18n 运行时
- 语言清单
s_i18n_type(b_id即语种编码,zh-CN 默认 / en-US);译文s_i18n(b_key, b_locale, b_value)。 - store
stores/i18n.js:loadLanguages()拉清单、loadMessages(locale)拉译文(按语种缓存 + 并发去重 + 失败静默;只把「当前语种」的译文写进运行时)。别只看 locale —— 不调 loadMessages 界面不会变。 - 合并顺序 前端内置 < 库表译文:内置只有 en-US 的
common.*(src/i18n/builtin-messages.js, 代码约定t('common.x', '中文兜底'));业务文案/字段名/菜单名的译文一律进s_i18n由实施维护。 - 现状:
s_i18n只登记了 zh-CN(约 134 条),en-US 尚无数据 → 英文界面只有框架按钮/提示是英文, 字段名等仍回落中文,需要补录。 - 顶栏语种下拉取自
s_i18n_type清单,不要硬编码语言编码。 - 查询区(
FmsQueryToolbar)已改用 Form/FormItem,因此也跟随该配置;Form 根靠display: contents透明化,让 FormItem 直接参与.query-grid(minmax(0,200px))布局,label 宽局部 72px。 高级查询面板(FmsAdvancedQueryPanel)仍是自绘.filter-*,不受表单布局配置影响。
模块管理页的分节布局(2026-09-24)
- 右栏是「卡头(模块名 + 动作)+ 分节导航(
mm-config-nav,Tabsnav-only)+.mm-config-stack」; 每个分节是.mm-config-pane(flex:1; overflow:auto; padding:12px 16px 16px),滚动由它负责。 - 面板自身不要做「撑满 + 内部滚动」:需要一页平铺时用
flex: 1 0 auto(内容少时填满、内容多时 撑高让.mm-config-pane滚动)。ModuleQueryConfigPanel已按此改造 —— 四个分节(更多条件字段 / 工作队列页签 / 关键词字段 / 快捷筛选字段)同页平铺,不再用内层页签。 FmsTable必须有确定高度(根.fms-table是height:100%,且虚拟滚动要容器尺寸)。 平铺多个表格时不能靠flex:1撑满,要按行数算高度:表头 34 + 行数×30 + 2, clamp 到 140~420px(见ModuleQueryConfigPanel.tableHeightOf),超出上限才在表格内部滚动。
导出(P0 已落地)
POST /api/export/list返回文件流:SqlPermissionService→ExportSchemaService(列与列表同源推导) →ExportService(Fesod 流式写)→ xlsx。导出列不由前端传,否则字段权限形同虚设; 校验必须在getOutputStream()前完成。- 依赖
org.apache.fesod:fesod-sheet:2.0.2-incubating(自带 POI,别再引)。 - Fesod 坑:0 行也要调一次
write,否则无工作表;合计行要自己构造标签。 - 权限现状:
s_power只有 2 行,非超管会被拒,g3soft 可直接用。