diff --git a/docs/architecture.md b/docs/architecture.md index 836bb92..33c710c 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -59,8 +59,10 @@ export default { 部分页签由独立仓库的子项目经 git submodule 集成,mainPage 侧用包装器 import 子项目 `App.vue` 作为路由组件(非 iframe),共享构建与 KeepAlive 缓存: -- **timeTableFix**(`third_party/timeTableFix`,日程整理页签):无 i18n,子项目硬编码中文。详见 [submodule-timeTableFix.md](./submodule-timeTableFix.md)。 -- **z449**(`third_party/z449`,移动游戏页签):子项目自带独立 `vue-i18n` 实例与 locale 文案。mainPage 包装器把当前语言经 `:locale` prop 透传,子项目 `App.vue` `watch` 该 prop 同步到自己的 i18n 实例,从而跟随父项目语言开关响应式切换(不共享 messages,仅同步 locale 值)。详见 [submodule-z449.md](./submodule-z449.md)。 +- **timeTableFix**(`third_party/timeTableFix`,日程整理页签):自带独立 `vue-i18n` 实例与中英 locale 文案。与 z449 同样经 `:locale` prop 桥接父项目语言。详见 [submodule-timeTableFix.md](./submodule-timeTableFix.md)。 +- **z449**(`third_party/z449`,移动游戏页签):自带独立 `vue-i18n` 实例与 locale 文案。mainPage 包装器把当前语言经 `:locale` prop 透传,子项目 `App.vue` `watch` 该 prop 同步到自己的 i18n 实例,从而跟随父项目语言开关响应式切换(不共享 messages,仅同步 locale 值)。详见 [submodule-z449.md](./submodule-z449.md)。 + +> **i18n 桥接关键点**:子项目组件用各自 `useLocale` composable **直接读自身模块级 i18n 实例**(`i18n.global`),而非 `useI18n({ useScope: 'global' })`。后者在嵌入时会解析到宿主已安装的 i18n 实例(不含子项目文案),导致文案回退成 i18n key(显示 ID 而非文字)。 ## 存活校验(requiresAlive) diff --git a/docs/submodule-z449.md b/docs/submodule-z449.md index 949f9d3..112ebe1 100644 --- a/docs/submodule-z449.md +++ b/docs/submodule-z449.md @@ -61,9 +61,10 @@ git commit -m "chore: 移除 z449 子模块集成" ## 与 timeTableFix 子模块的差异 -| 维度 | timeTableFix | z449 | -|------|--------------|------| -| i18n | 无(硬编码中文) | 自带独立 vue-i18n,中英双语 | -| 语言同步 | 无需 | 经 `:locale` prop 桥接父项目语言 | -| 文案来源 | 组件内硬编码 | z449 自有 locale 文件(单一来源) | -| mainPage 侧文案 | 无 | 仅 `tabs.mobileGame` 页签标题 | +| 维度 | 早期 timeTableFix | timeTableFix(现已 i18n) | z449 | +|------|-------------------|---------------------------|------| +| i18n | 无(硬编码中文) | 自带独立 vue-i18n,中英双语 | 自带独立 vue-i18n,中英双语 | +| 语言同步 | 无需 | 经 `:locale` prop 桥接 | 经 `:locale` prop 桥接 | +| 文案来源 | 组件内硬编码 | ttf 自有 locale 文件(单一来源) | z449 自有 locale 文件(单一来源) | + +两个子项目均采用相同的 i18n 桥接模式:各自维护独立 `vue-i18n` 实例与 locale 文案,组件内用 `useLocale` composable **直接读自身实例**(而非 `useI18n()` 注入,否则嵌入时会解析到宿主实例导致文案回退成 key),mainPage 侧包装器经 `:locale` prop 透传当前语言。 diff --git a/src/modules/timetable/Timetable.vue b/src/modules/timetable/Timetable.vue index 3944b41..742413a 100644 --- a/src/modules/timetable/Timetable.vue +++ b/src/modules/timetable/Timetable.vue @@ -1,19 +1,26 @@ diff --git a/third_party/timeTableFix b/third_party/timeTableFix index 2d7b8d0..960657a 160000 --- a/third_party/timeTableFix +++ b/third_party/timeTableFix @@ -1 +1 @@ -Subproject commit 2d7b8d0d077c0cf3b4fc4961bb67025abbbed079 +Subproject commit 960657a251b1f19fa81447b9140257eb9a8506be diff --git a/third_party/z449 b/third_party/z449 index a5d4c05..a91c379 160000 --- a/third_party/z449 +++ b/third_party/z449 @@ -1 +1 @@ -Subproject commit a5d4c05392482235496d0f45b80226e7b025df4f +Subproject commit a91c379096e1789870e7a8bb65cf30456c2a8992