NUXTnuxt 国际化 注意事项


最近公司有一个官网项目需要增加多语言，项目使用的是vue + nuxt + iview 框架。

安装依赖 npm install --save vue-i18n

根据nuxt官网的国际化demo，完成项目的国际化部署。

官网Demo : https://zh.nuxtjs.org/examples/i18n

其中要注意的几点

1、nuxt.config.js 中

1
2
3
4
5
6
7
8
9
10
plugins: [
    {
      src: '~plugins/i18n.js',
      // ssr: false    这个东西一定不要加，加上的话即便值为false，也会报错，i18n 失效
    },
    {
      src: '~plugins/vue-iview',
      ssr: false
    }
  ],

2、为了能够做到切换语言时页面不抖动，刷新后页面保持当前的语种，那么请一定按照官网Demo的示例来切换语种

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<!-- 以下示例中文为默认语种 -->

<!-- 第一种方式，在HTML中直接切换语种 -->

<nuxt-link :to="$route.fullPath.replace(/^\/[^\/]+/, '')" >中文</nuxt-link>
<nuxt-link :to="`/fr` + $route.fullPath" >法语</nuxt-link>


<!-- 第二种方式，通过点击事件切换语种 -->

<nuxt-link @click="changeLanguage('zh')">中文</nuxt-link>
<nuxt-link @click="changeLanguage('fr')">法语</nuxt-link>

<script>
    methods: {
        changeLanguage(language) {
          let locale = this.$store.state.locale
          if (language === 'zh') {
            this.$router.push(this.$route.fullPath.replace(/^\/[^\/]+/, ''))
          } else if (language === 'en') {
            // 防止重复点击
            if(locale !== 'en'){
              this.$router.push(`/en` + this.$route.fullPath)
            }
          }
        }
    }
</script>

3、在pages下创建_lang文件夹，名称必须是_lang，将pages下已有项目全部拷贝至_lang文件夹内，然后在原有页面中写如下代码引入_lang 文件夹内的页面

1
2
3
4
<script>
import Index from '~/pages/_lang/index'
export default Index
</script>

4、nuxt 国际化 的跳转以及传参

注意，path后的路径开头不要加 “ / ”

1
2
3
4
5
6
7
8
9
10
11
<!-- 跳转页面 -->
<nuxt-link :to="$i18n.path('home/index')" >跳转</nuxt-link>
<!-- 携带参数 -->
<nuxt-link :to="{path:$i18n.path('home/index'), query:{id:xxx}}" >跳转</nuxt-link>

<script>
    // 跳转页面
    this.$router.push(this.$i18n.path("home/index"))
    // 携带参数
    this.$router.push({ path: this.$i18n.path("home/index"), query:{id: 'xxxx'} })
</script>

其余的按照官网Demo照搬即可

如此配置后，项目的国际化已经部署完毕

nuxt中i18n的使用方法：

1、在template中使用i18n

1
<h1>{{ $t('home.title') }}</h1>

2、在.vue页面中的script内使用i18n

1
2
3
4
5
data() {
    return {
        title: this.$t('home.title')
    }
}

3、在.js页面中使用i18n （.js页面中没有vue实例，所以this.$t失效）（不推荐）

1、在layouts文件夹下的default.vue的mounted中将i18n挂载到window上

或者 挂载到 plugins 下的 i18n.js 内

1
2
3
4
// default.vue
mounted() {
    window.vm = this.$i18n
}

2、在.js页面内使用

1
2
3
4
5
6
7
8
// test.js

if (process.browser) { //判断是否在浏览器环境下
    let vm = window.vm
    let data = {
        home:vm.t('home.title'),
    }
}

不过经测试会偶发静态资源加载快于window挂载i18n的速度，导致window上还未成功挂载i18n，静态资源就开始使用的情况。

最后一种方案

所以我最终采用最保险的方式实现静态资源中英版的替换

1、将静态资源的中英两个版本同时引入到该页面

2、判断locale的值，如果是中文就使用中文版的静态资源赋值，如果是英文就采用英文版的静态资源赋值

实现如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import ChineseData form '~/static/assets/libs/staticData_zh.js' // 中文资源
import EnglishData form '~/static/assets/libs/staticData_en.js' // 英文资源

export default {
    components: {},
    data() {
        return {
            text: {}
        }
    },
    created() {
        //判断当前语言环境，进行静态资源的赋值
        let locale = this.$store.state.locale
        if (locale === 'zh') {
          this.text = ChineseData.text
        } else if (locale === 'en') {
          this.text = EnglishData.text
        }
    }
}

初次接触NUXT，有很多不是特别透彻的地方，如果有更好的建议，欢迎评论~

如果能够帮到你，可以给我一个赞吗？ 不胜感激~