如何使用 `react-i18next` 来国际化一段包含 React 组件的文本

本文将展示如何使用 react-i18next 来国际化一段包含 React 组件(如 <Link>)的文本。以下是一个完整的示例,涵盖配置和使用方法:

1. 安装依赖

首先,确保安装了必要的包:

bash 复制代码
npm install i18next react-i18next

2. 配置 i18next

创建一个 i18n.js 文件来初始化 i18next

javascript 复制代码
// i18n.js
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';

// 定义多语言资源
const resources = {
  en: {
    translation: {
      welcome: 'Welcome to our <1>website</1>',
    },
  },
  zh: {
    translation: {
      welcome: '欢迎访问我们的<1>网站</1>',
    },
  },
};

i18n
  .use(initReactI18next)
  .init({
    resources,
    lng: 'en', // 默认语言
    interpolation: {
      escapeValue: false, // React 已经处理了 XSS
    },
  });

export default i18n;

3. 在 React 应用中集成

在你的主应用文件中(例如 index.jsApp.js)引入 i18n 配置:

javascript 复制代码
// index.js
import React from 'react';
import ReactDOM from 'react-dom';
import './i18n'; // 引入 i18n 配置
import App from './App';

ReactDOM.render(<App />, document.getElementById('root'));

4. 使用 react-i18next 国际化带组件的文本

在组件中使用 useTranslation 钩子,并结合 <Trans> 组件来处理包含 React 组件的翻译:

javascript 复制代码
// App.js
import React from 'react';
import { useTranslation, Trans } from 'react-i18next';
import { Link } from 'react-router-dom'; // 假设使用 react-router-dom

function App() {
  const { t, i18n } = useTranslation();

  // 切换语言的函数
  const changeLanguage = (lng) => {
    i18n.changeLanguage(lng);
  };

  return (
    <div>
      <h1>React i18next 示例</h1>
      {/* 使用 Trans 组件处理带 React 组件的翻译 */}
      <Trans i18nKey="welcome" components={{ 1: <Link to="/home" /> }}>
        Welcome to our <Link to="/home">website</Link>
      </Trans>

      {/* 语言切换按钮 */}
      <div>
        <button onClick={() => changeLanguage('en')}>English</button>
        <button onClick={() => changeLanguage('zh')}>中文</button>
      </div>
    </div>
  );
}

export default App;

5. 翻译文件结构

确保翻译文件中的占位符(如 <1>)与 <Trans> 组件中的 components 属性对应。components 对象的键(如 1)对应翻译字符串中的 <1>,值是实际的 React 组件(如 <Link>)。

翻译资源示例(已在 i18n.js 中定义):

json 复制代码
{
  "en": {
    "translation": {
      "welcome": "Welcome to our <1>website</1>"
    }
  },
  "zh": {
    "translation": {
      "welcome": "欢迎访问我们的<1>网站</1>"
    }
  }
}

6. 运行效果

  • 当语言为 en 时,页面显示:Welcome to our websitewebsite 是可点击的 <Link>)。
  • 当语言为 zh 时,页面显示:欢迎访问我们的网站网站 是可点击的 <Link>)。
  • 点击语言切换按钮可动态切换语言。
相关推荐
sanx185 小时前
一站式电竞平台解决方案:数据、直播、源码,助力业务飞速启航
前端·数据库·apache·数据库开发·时序数据库
余防6 小时前
存储型XSS,反射型xss
前端·安全·web安全·网络安全·xss
ObjectX前端实验室6 小时前
从零到一:系统化掌握大模型应用开发【目录】
前端·llm·agent
guoyp21266 小时前
前端实验(二)模板语法
前端·vue.js
葡萄城技术团队6 小时前
Excel 转在线协作难题破解:SpreadJS 纯前端表格控件的技术方案与实践
前端·excel
我的xiaodoujiao6 小时前
Windows系统Web UI自动化测试学习系列3--浏览器驱动下载使用
前端·windows·测试工具·ui
一只小风华~6 小时前
学习笔记:Vue Router 中的嵌套路由详解[特殊字符]概述
前端·javascript·vue.js
泻水置平地6 小时前
若依前后端分离版实现前端国际化步骤
前端
Villiam_AY6 小时前
从后端到react框架
前端·react.js·前端框架
CodeCraft Studio6 小时前
全球知名的Java Web开发平台Vaadin上线慧都网
java·开发语言·前端·vaadin·java开发框架·java全栈开发·java ui 框架