页面文案接入 react-i18next 后,切换语言可以触发 React 更新。微信原生 TabBar 来自应用配置,还需要通过平台接口更新文字。
页面已经切成英文,原生 TabBar 仍显示中文
点击切换语言,页面文字发生变化,底部导航却保留原来的中文。只调用 changeLanguage 时,i18next 更新了订阅它的 React 组件,没有修改原生导航项。
src/app.config.ts 静态声明两个导航项:
export default defineAppConfig({
pages: ['pages/dashboard', 'pages/devices'],
tabBar: {
list: [
{ pagePath: 'pages/dashboard', text: '主页' },
{ pagePath: 'pages/devices', text: '设备' },
],
},
});
页面只负责切换 i18next 语言:
import { useTranslation } from 'react-i18next';
import { View } from '@tarojs/components';
export function LanguageSwitch() {
const { t, i18n } = useTranslation();
return (
<View onClick={() => void i18n.changeLanguage('en-US')}>
{t('action.save')}
</View>
);
}
这里假设英文资源已经存在。页面文案能变化,不代表编译后交给小程序读取的 app.config.ts 会重新执行。原生 TabBar 不属于 I18nextProvider 的 React 子树,需要 setTabBarItem 更新。
保留静态默认文字,再把语言事件同步到平台接口。src/i18n.ts 中的资源和初始化如下:
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
void i18n.use(initReactI18next).init({
lng: 'zh-CN',
fallbackLng: 'zh-CN',
resources: {
'zh-CN': { translation: {
action: { save: '保存' },
mini: { tabs: { home: '主页', devices: '设备' } },
} },
'en-US': { translation: {
action: { save: 'Save' },
mini: { tabs: { home: 'Home', devices: 'Devices' } },
} },
},
});
export { i18n };
在 src/app.tsx 注册更新逻辑,@ 表示已配置到 src 的别名,未配置时使用相应相对路径:
import { useEffect, type PropsWithChildren } from 'react';
import Taro from '@tarojs/taro';
import { i18n } from '@/i18n';
const tabBarValues = ['home', 'devices'] as const;
function refreshTabBar() {
tabBarValues.forEach((value, index) => {
void Taro.setTabBarItem({
index,
text: i18n.t(`mini.tabs.${value}`),
});
});
}
export default function App({ children }: PropsWithChildren) {
useEffect(() => {
refreshTabBar();
i18n.on('languageChanged', refreshTabBar);
return () => i18n.off('languageChanged', refreshTabBar);
}, []);
return children;
}
首次调用同步当前语言,languageChanged 处理后续切换,清理时移除同一个回调。翻译资源和监听逻辑缺一项,都可能使导航文字保留旧值。
数组顺序与 tabBar.list 对应。home 可以映射到 dashboard 页面,翻译 key 不必等于文件名,但 index 必须对应正确导航项。
重新编译后,在原生 TabBar 可见的页面检查首次进入和连续切换。若 API 调用时导航尚不可用,应根据失败结果调整同步时机;注册监听不等于平台调用一定成功。
页面内的 TDesign t-tab-bar 等组件与原生导航使用不同渲染路径,组件文字更新正常,不能代替对原生 TabBar 的检查。