jiojio-jx / react-inter Goto Github PK

 npm install react-i18next i18next --save
 
 既然是要学习使用react-i18next，为什么还需要安装i18next包？
 
 i18next才是提供所有翻译功能的核心,react-i18next是为了与 react一起使用提供了一些额外的功能。

 大家看下zh-cn.json文件的数据结构，繁体和英文结构是一样的，只是内容不同。  

{
  "home":{
    "title":"首页",
    "content":"我是首页",
  },
  "about":{
    "title":"关于我们",
    "content":"我是关于我们"
  }
}

import i18n from "i18next";
import { initReactI18next } from "react-i18next";
//i18next-browser-languagedetector插件 这是一个 i18next 语言检测插件，用于检测浏览器中的用户语言，
//详情请访问：https://github.com/i18next/i18next-browser-languageDetector
import LanguageDetector from 'i18next-browser-languagedetector';
//引入需要实现国际化的简体、繁体、英文三种数据的json文件
import cn from './locales/zh-cn.json'
import hk from './locales/zh-HK.json'
import en from './locales/en-us.json'
const resources = {
  cn: {
    translation: cn
  },
  hk: {
    translation: hk
  },
  en: {
    translation: en
  },
};
i18n.use(LanguageDetector) //嗅探当前浏览器语言 zh-CN
.use(initReactI18next) // 将 i18n 向下传递给 react-i18next
  .init({ //初始化
    resources, //本地多语言数据
    fallbackLng: "cn", //默认当前环境的语言
    detection: {
      caches: ['localStorage', 'sessionStorage', 'cookie'],
    }
  })

export default i18n

这样的话react-i18next和i18next 就可以作用到App组件以及它的所有子组件上了。

 项目初始化后，用户浏览器的默认语言为zh-CN
 根据react-i18next-config.js文件中关于resources的配置：

"zh-CN": {
    translation: './locales/zh-cn.json'
  },
  "zh-HK": {
    translation: './locales/zh-HK.json'
  },
  "en-US": {
    translation: './locales/en-us.json'
  },

 根据上述配置我们可以判断出默认请求的数据为./locales/zh-cn.json

   <div>
       <label>语言切换</label>
       <select value={language} onChange={(e)=>changeLanguage(e)}>
         <option value="zh-CN">简</option>
         <option value="zh-HK">繁</option>
         <option value="en-US">英</option>
       </select>
    </div>       

当我们进行语言切换时，将调用组件中的changeLanguage方法。

这个方法的调用会做下面几件事：

1、对当前选择的语言类型进行更新操作 
  const [language,setLanguage] = useState('zh-CN')
  setLanguage(当前选中的语言类型)，更新页面中选中的语言类型对应的文字
  
2.执行由react-i18next-config.js导出的i18n上面的changeLanguage
  (当前选中的语言类型)方法。
  
  执行了i18n.changeLanguage后：
  
  a.更新数据源
    "zh-CN": {
        translation: './locales/zh-cn.json'
      },
      "zh-HK": {
        translation: './locales/zh-HK.json'
      },
      "en-US": {
        translation: './locales/en-us.json'
      },
    根据选中的语言类型去获取对应的json数据
    
  b.更新语言类型
    localStorage中i18nextLng的值

   安装i18next-browser-languagedetector插件后，可以探测出当前浏览器的用户语言为zh-CN。
   此时会在localStorage中设置i18nextLng为zh-CN。

   那么这里为什么会在localStorage中存储呢？键值为什么是i18nextLng呢?

如果我们需要自定义的话 可以通过官方文档中的Detector Options进行配置,例如：
初始化项目后，我们不仅希望localStorage中存储了i18nextLng，
同时希望在sessionStorage、cookie中也存储i18nextLng。
可以进行如下配置：
detection: {
    caches: ['localStorage', 'sessionStorage', 'cookie'],
}
将上述配置放到i18n初始化init的配置对象中去就可以了。

众所周知，localStorage是不会随着页面刷新、标签关闭造成数据丢失的，
也就是说当我们刷新页面时，我们仍然可以拿到上一次用户选择的语言类型，
并且按照这个语言类型去加载对应的json文件数据。

 注意：useTranslation()必须是函数组件中使用否则会报，hooks错误。  

 const { t } = useTranslation()
 <NavLink to="/home">{t('home.title')}</NavLink>

import {Translation} from 'react-i18next'

<Translation>
  {(t) => <h3>{t("about.content")}</h3>}
</Translation>

 react-i18next 内部封装了一个高阶组件withTranslation,
 我们需要利用这个高阶组件把我们自己的组件包装一次

import { withTranslation } from 'react-i18next'; 
//类组件
class Home extends Component {
  render() {
    const {t} = this.props

    return (
      <div>
          <h3>{t("home.content")}</h3>
      </div>
    )
  }
}
//函数组件
const Home = ({t})=>{
  return (
    <div>
        <h3>{t("home.content")}</h3>
    </div>
  )
}
//组件导出：
export default withTranslation()(Home)