背景
楼主最近新接了一个项目,从0开始做,需要做多语言的国际化,今天搞了一下,基本达到了想要的效果, 在这里简单分享下:
一些探索
也说不上是探索吧,就Google了一波, 去gayHub 上找了一个比较成熟的库 react-i18next
, 写了一些代码,现将过程分享一下, 附带详细代码,手把手教你实现国际化。
先睹为快
先看一下最后的成果:
// ... import i18n from '@src/i18n'; // xxx component console.log('哈哈哈哈哈i18n来一发:', i18n.t('INVALID_ORDER')); // ... render() { // ... <button> {i18n.t('INVALID_ORDER')} <button> }
控制台中:
对应json 中的信息:
开始
原理
原理其实很简单: 字符串替换。
拉取远程的国际化json文件到本地,再根据语言做一个映射就可以了。
废话不多说, 来看代码吧。
先简单看一下目录结构:
先看一下 config
里面的 相关代码:
env.js
:
'use strict'; const fs = require('fs'); const path = require('path'); const paths = require('./paths'); const languages = require('./languages'); // Make sure that including paths.js after env.js will read .env variables. delete require.cache[require.resolve('./paths')]; const NODE_ENV = process.env.NODE_ENV; if (!NODE_ENV) { throw new Error( 'The NODE_ENV environment variable is required but was not specified.' ); } // https://github.com/bkeepers/dotenv#what-other-env-files-can-i-use var dotenvFiles = [ `${paths.dotenv}.${NODE_ENV}.local`, `${paths.dotenv}.${NODE_ENV}`, // Don't include `.env.local` for `test` environment // since normally you expect tests to produce the same // results for everyone NODE_ENV !== 'test' && `${paths.dotenv}.local`, paths.dotenv, ].filter(Boolean); // Load environment variables from .env* files. Suppress warnings using silent // if this file is missing. dotenv will never modify any environment variables // that have already been set. Variable expansion is supported in .env files. // https://github.com/motdotla/dotenv // https://github.com/motdotla/dotenv-expand dotenvFiles.forEach(dotenvFile => { if (fs.existsSync(dotenvFile)) { require('dotenv-expand')( require('dotenv').config({ path: dotenvFile, }) ); } }); // We support resolving modules according to `NODE_PATH`. // This lets you use absolute paths in imports inside large monorepos: // https://github.com/facebookincubator/create-react-app/issues/253. // It works similar to `NODE_PATH` in Node itself: // https://nodejs.org/api/modules.html#modules_loading_from_the_global_folders // Note that unlike in Node, only *relative* paths from `NODE_PATH` are honored. // Otherwise, we risk importing Node.js core modules into an app instead of Webpack shims. // https://github.com/facebookincubator/create-react-app/issues/1023#issuecomment-265344421 // We also resolve them to make sure all tools using them work consistently. const appDirectory = fs.realpathSync(process.cwd()); process.env.NODE_PATH = (process.env.NODE_PATH || '') .split(path.delimiter) .filter(folder => folder && !path.isAbsolute(folder)) .map(folder => path.resolve(appDirectory, folder)) .join(path.delimiter); // Grab NODE_ENV and REACT_APP_* environment variables and prepare them to be // injected into the application via DefinePlugin in Webpack configuration. const REACT_APP = /^REACT_APP_/i; function getClientEnvironment(publicUrl) { const raw = Object.keys(process.env) .filter(key => REACT_APP.test(key)) .reduce( (env, key) => { env[key] = process.env[key]; return env; }, { // Useful for determining whether we're running in production mode. // Most importantly, it switches React into the correct mode. NODE_ENV: process.env.NODE_ENV || 'development', // Useful for resolving the correct path to static assets in `public`. // For example, <img src={process.env.PUBLIC_URL + '/img/logo.png'} />. // This should only be used as an escape hatch. Normally you would put // images into the `src` and `import` them in code to get their paths. PUBLIC_URL: publicUrl, LANGUAGE: { resources: languages.resources, defaultLng: languages.defaultLng }, COUNTRY: process.env.COUNTRY } ); // Stringify all values so we can feed into Webpack DefinePlugin const stringified = { 'process.env': Object.keys(raw).reduce((env, key) => { env[key] = JSON.stringify(raw[key]); return env; }, {}), }; return { raw, stringified }; } module.exports = getClientEnvironment;
主要看lannguage 相关的代码就好了, 其他的都create-react-app
的相关配置, 不用管。
再看下 language.js
里面的逻辑:
const path = require('path'); const paths = require('./paths'); const localesHash = require('../i18n/localesHash'); const resourcesHash = require('../i18n/resourcesHash'); const COUNTRY = process.env.COUNTRY || 'sg'; const country = (COUNTRY).toUpperCase(); const defaultLng = localesHash[country][0]; const langs = [ 'en', 'id' ]; const prefixLangs = []; const entries = {}; for (let i = 0, len = langs.length; i < len; i++) { const prefixLang = `dict_${langs[i]}` prefixLangs.push(prefixLang) entries[prefixLang] = path.resolve(paths.appSrc, `../i18n/locales/${langs[i]}.json`) } const resources = { [defaultLng]: { common: resourcesHash[defaultLng] } } exports.resources = resources; exports.defaultLng = defaultLng;
逻辑也比较简单, 根据语言列表把对应的json 内容加进来。 作为示例,这里我设置的是 英文 和 印尼语。
下面看 i18n
文件里面的内容:
locales
里面放的是语言的json 文件, 内容大概是:
{ "msg_Created": "Pesanan telah terbuat" // ... }
localesHash.js
:
module.exports = { SG: ['en'], ID: ['id'] }
resourcesHash.js
:
module.exports = { 'en': require('./locales/en.json'), 'id': require('./locales/id.json') }
index.js
const path = require('path') const fs = require('fs') const fetch = require('isomorphic-fetch') const localesHash = require('./localesHash') const argv = process.argv.slice(2) const country = (argv[0] || '').toUpperCase() const i18nServerURI = locale => { const keywords = { 'en': 'en', 'id': 'id' } const keyword = keywords[locale] return keyword === 'en' "htmlcode">import i18next from 'i18next' import { firstLetterUpper } from './common/helpers/util'; const env = process.env; let LANGUAGE = process.env.LANGUAGE; LANGUAGE = typeof LANGUAGE === 'string' "htmlcode">// firstLetterUpper export const firstLetterUpper = (str, allWords = true) => { let tmp = str.replace(/^(.)/g, $1 => $1.toUpperCase()) if (allWords) { tmp = tmp.replace(/\s(.)/g, $1 => $1.toUpperCase()) } return tmp; }这些准备工作做好后, 还需要把i18n 注入到app中:
index.js
:import React from 'react'; import { render } from 'react-dom'; import { Provider } from 'react-redux'; import rootReducer from './common/redux/reducers'; import { configureStore } from './common/redux/store'; import { Router } from 'react-router-dom'; import createBrowserHistory from 'history/createBrowserHistory'; import { I18nextProvider } from 'react-i18next'; import i18n from './i18n'; import './common/styles/index.less'; import App from './App'; export const history = createBrowserHistory(); const ROOT = document.getElementById('root'); render( <I18nextProvider i18n={i18n}> <Provider store={configureStore(rootReducer)} > <Router history={history}> <App /> </Router> </Provider> </I18nextProvider>, ROOT );如何使用
加入上面的代码后, 控制台会有一些log 信息, 表示语言已经加载好了。
在具体的业务组件中,使用方法是:
// ... import i18n from '@src/i18n'; console.log('哈哈哈哈哈i18n来一发:', i18n.t('INVALID_ORDER'));控制台中:
对应json 中的信息:
后面你就可以愉快的加各种词条了。
Tips
我们在src 中的文件中引入了src 目录外的文件, 这是create-react-app 做的限制, 编译会报错, 把它去掉就好了:
结语
这里作为例, 就是把语言的json 文件下载下来放到locales 目录里, 如果想实时拉取,要保证文件下载完之后再render app.
类似:
loadResource(getLocale()) .then(() => { import('./app.js') })当然你也可以免了这一步,直接下载好放到工程里来。
大概就是这样,以上就是实现国际化的全部代码,希望对大家有所帮助。也希望大家多多支持。
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
稳了!魔兽国服回归的3条重磅消息!官宣时间再确认!
昨天有一位朋友在大神群里分享,自己亚服账号被封号之后居然弹出了国服的封号信息对话框。
这里面让他访问的是一个国服的战网网址,com.cn和后面的zh都非常明白地表明这就是国服战网。
而他在复制这个网址并且进行登录之后,确实是网易的网址,也就是我们熟悉的停服之后国服发布的暴雪游戏产品运营到期开放退款的说明。这是一件比较奇怪的事情,因为以前都没有出现这样的情况,现在突然提示跳转到国服战网的网址,是不是说明了简体中文客户端已经开始进行更新了呢?
更新日志
- 凤飞飞《我们的主题曲》飞跃制作[正版原抓WAV+CUE]
- 刘嘉亮《亮情歌2》[WAV+CUE][1G]
- 红馆40·谭咏麟《歌者恋歌浓情30年演唱会》3CD[低速原抓WAV+CUE][1.8G]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[320K/MP3][193.25MB]
- 【轻音乐】曼托凡尼乐团《精选辑》2CD.1998[FLAC+CUE整轨]
- 邝美云《心中有爱》1989年香港DMIJP版1MTO东芝首版[WAV+CUE]
- 群星《情叹-发烧女声DSD》天籁女声发烧碟[WAV+CUE]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[FLAC/分轨][748.03MB]
- 理想混蛋《Origin Sessions》[320K/MP3][37.47MB]
- 公馆青少年《我其实一点都不酷》[320K/MP3][78.78MB]
- 群星《情叹-发烧男声DSD》最值得珍藏的完美男声[WAV+CUE]
- 群星《国韵飘香·贵妃醉酒HQCD黑胶王》2CD[WAV]
- 卫兰《DAUGHTER》【低速原抓WAV+CUE】
- 公馆青少年《我其实一点都不酷》[FLAC/分轨][398.22MB]
- ZWEI《迟暮的花 (Explicit)》[320K/MP3][57.16MB]