开始使用 Intlayer 和 React Create App 进行国际化 (i18n)

import { t, type DeclarationContent } from "intlayer";import React, { type ReactNode } from "react";const appContent = {  key: "app",  content: {    getStarted: t<ReactNode>({      en: (        <>          编辑 <code>src/App.tsx</code> 并保存以重新加载        </>      ),      fr: (        <>          Éditez <code>src/App.tsx</code> et enregistrez pour recharger        </>      ),      es: (        <>          Edita <code>src/App.tsx</code> y guarda para recargar        </>      ),    }),    reactLink: {      href: "https://reactjs.org",      content: t({        en: "学习 React",        fr: "Apprendre React",        es: "Aprender React",      }),    },  },} satisfies DeclarationContent;export default appContent;

import logo from "./logo.svg";import "./App.css";import type { FC } from "react";import { IntlayerProvider, useIntlayer } from "react-intlayer";const AppContent: FC = () => {  const content = useIntlayer("app");  return (    <div className="App">      <img src={logo} className="App-logo" alt="logo" />      {content.getStarted}      <a        className="App-link"        href={content.reactLink.href.value}        target="_blank"        rel="noopener noreferrer"      >        {content.reactLink.content}      </a>    </div>  );};const App: FC = () => (  <IntlayerProvider>    <AppContent />  </IntlayerProvider>);export default App;

import { Locales } from "intlayer";import { useLocale } from "react-intlayer";const LocaleSwitcher = () => {  const { setLocale } = useLocale();  return (    <button onClick={() => setLocale(Locales.English)}>更改语言为英语</button>  );};

// 导入必要的依赖和函数import { Locales, getConfiguration, getPathWithoutLocale } from "intlayer"; // 从 'intlayer' 导入工具函数和类型import type { FC, PropsWithChildren } from "react"; // React 的函数组件和属性的类型import { IntlayerProvider } from "react-intlayer"; // 国际化上下文的提供程序import {  BrowserRouter,  Routes,  Route,  useParams,  Navigate,  useLocation,} from "react-router-dom"; // 管理导航的路由组件// 从 Intlayer 解构配置const { internationalization, middleware } = getConfiguration();const { locales, defaultLocale } = internationalization;/** * 处理本地化并使用适当的语言环境上下文包装子组件的组件。 * 它管理基于 URL 的语言环境检测和验证。 */const AppLocalized: FC<PropsWithChildren> = ({ children }) => {  const path = useLocation().pathname; // 获取当前 URL 路径  const { locale } = useParams<{ locale: Locales }>(); // 从 URL 中提取语言环境参数  // 确定当前语言环境，如果未提供则回退到默认语言环境  const currentLocale = locale ?? defaultLocale;  // 从路径中移除语言环境前缀以构造基础路径  const pathWithoutLocale = getPathWithoutLocale(    path // 当前 URL 路径  );  /**   * 如果 middleware.prefixDefault 为 true，则默认语言环境应始终前缀。   */  if (middleware.prefixDefault) {    // 验证语言环境    if (!locale || !locales.includes(locale)) {      // 重定向到默认语言环境并更新路径      return (        <Navigate          to={`/${defaultLocale}/${pathWithoutLocale}`}          replace // 用新条目替换当前历史记录条目        />      );    }    // 使用 IntlayerProvider 包裹子组件并设置当前语言环境    return (      <IntlayerProvider locale={currentLocale}>{children}</IntlayerProvider>    );  } else {    /**     * 当 middleware.prefixDefault 为 false 时，默认语言环境不带前缀。     * 确保当前语言环境有效且不是默认语言环境。     */    if (      currentLocale.toString() !== defaultLocale.toString() &&      !locales        .filter(          (locale) => locale.toString() !== defaultLocale.toString() // 排除默认语言环境        )        .includes(currentLocale) // 检查当前语言环境是否在有效语言环境列表中    ) {      // 重定向到没有语言环境前缀的路径      return <Navigate to={pathWithoutLocale} replace />;    }    // 使用 IntlayerProvider 包裹子组件并设置当前语言环境    return (      <IntlayerProvider locale={currentLocale}>{children}</IntlayerProvider>    );  }};/** * 设置语言环境特定路由的路由组件。 * 它使用 React Router 管理导航并渲染本地化组件。 */export const LocaleRouter: FC<PropsWithChildren> = ({ children }) => (  <BrowserRouter>    <Routes>      <Route        // 路由模式以捕获语言环境（例如，/en/，/fr/）并匹配所有后续路径        path="/:locale/*"        element={<AppLocalized>{children}</AppLocalized>} // 用语言管理包裹子组件      />      {        // 如果禁用默认语言环境的前缀，则在根路径直接渲染子组件        !middleware.prefixDefault && (          <Route            path="*"            element={<AppLocalized>{children}</AppLocalized>} // 用语言管理包裹子组件          />        )      }    </Routes>  </BrowserRouter>);

import { useLocation, useNavigate } from "react-router-dom";import {  Locales,  getHTMLTextDir,  getLocaleName,  getLocalizedUrl,} from "intlayer";import { useLocale } from "react-intlayer";import { type FC } from "react";const LocaleSwitcher: FC = () => {  const location = useLocation(); // 获取当前 URL 路径。例如：/fr/about  const navigate = useNavigate();  const changeUrl = (locale: Locales) => {    // 构造更新语言环境的 URL    // 示例：/es/about 将语言环境设置为西班牙语    const pathWithLocale = getLocalizedUrl(location.pathname, locale);    // 更新 URL 路径    navigate(pathWithLocale);  };  const { locale, availableLocales, setLocale } = useLocale({    onLocaleChange: changeUrl,  });  return (    <ol>      {availableLocales.map((localeItem) => (        <li key={localeItem}>          <a            href={getLocalizedUrl(location.pathname, localeItem)}            hrefLang={localeItem}            aria-current={locale === localeItem ? "page" : undefined}            onClick={(e) => {              e.preventDefault();              setLocale(localeItem);            }}          >            <span>              {/* 以其自己的语言环境显示语言 - 例如法语 */}              {getLocaleName(localeItem, locale)}            </span>            <span dir={getHTMLTextDir(localeItem)} lang={localeItem}>              {/* 以当前语言环境显示的语言 - 例如以 Locales.SPANISH 设置当前语言环境的法语 */}              {getLocaleName(localeItem)}            </span>            <span dir="ltr" lang={Locales.ENGLISH}>              {/* 英语中的语言 - 例如法语 */}              {getLocaleName(localeItem, Locales.ENGLISH)}            </span>            <span>              {/* 以其自己的语言环境显示语言 - 例如 FR */}              {localeItem}            </span>          </a>        </li>      ))}    </ol>  );};