国际化 (i18n)

Nuxt UI 支持 50 多种语言环境和多方向(从左到右/从右到左)国际化。

用法

Nuxt UI 提供了一个 App 组件,用于包装你的应用,提供全局配置。

语言环境

使用 locale 属性,并从 @nuxt/ui/locale 中选择您想要使用的语言环境。

App.vue
<script setup lang="ts">
import { fr } from '@nuxt/ui/locale'
</script>

<template>
  <UApp :locale="fr">
    <RouterView />
  </UApp>
</template>

自定义语言环境

您可以使用 defineLocale 可组合函数创建自己的语言环境。

App.vue
<script setup lang="ts">
import type { Messages } from '@nuxt/ui'
import { defineLocale } from '@nuxt/ui/composables/defineLocale.js'

const locale = defineLocale<Messages>({
  name: 'My custom locale',
  code: 'en',
  dir: 'ltr',
  messages: {
    // implement pairs
  }
})
</script>

<template>
  <UApp :locale="locale">
    <RouterView />
  </UApp>
</template>
查看 code 参数,您需要在此处传递语言的 ISO 代码。例如:
  • hi 印地语(语言)
  • de-AT:奥地利使用的德语(语言)

扩展语言环境

您可以通过使用 extendLocale 可组合函数覆盖其 messagescode 来定制现有语言环境。

App.vue
<script setup lang="ts">
import { en } from '@nuxt/ui/locale'
import { extendLocale } from '@nuxt/ui/composables/defineLocale.js'

const locale = extendLocale(en, {
  code: 'en-GB',
  messages: {
    commandPalette: {
      placeholder: 'Search a component...'
    }
  }
})
</script>

<template>
  <UApp :locale="locale">
    <RouterView />
  </UApp>
</template>

动态区域设置

要动态切换语言,您可以使用Vue I18n插件。

安装 Vue I18n 包

pnpm add vue-i18n@11

在您的 main.ts 中使用 Vue I18n 插件

main.ts
import { createApp } from 'vue'
import { createRouter, createWebHistory } from 'vue-router'
import { createI18n } from 'vue-i18n'
import ui from '@nuxt/ui/vue-plugin'
import App from './App.vue'

const app = createApp(App)

const router = createRouter({
  routes: [],
  history: createWebHistory()
})

const i18n = createI18n({
  legacy: false,
  locale: 'en',
  availableLocales: ['en', 'de'],
  messages: {
    en: {
      // ...
    },
    de: {
      // ...
    }
  }
})

app.use(router)
app.use(i18n)
app.use(ui)

app.mount('#app')

使用 useI18n 设置 locale 属性。

App.vue
<script setup lang="ts">
import { useI18n } from 'vue-i18n'
import * as locales from '@nuxt/ui/locale'

const { locale } = useI18n()
</script>

<template>
  <UApp :locale="locales[locale]">
    <RouterView />
  </UApp>
</template>

动态方向

每个语言环境都有一个 dir 属性,App 组件将使用该属性来设置所有组件的方向。

在多语言应用程序中,您可能希望根据用户的语言环境动态设置 langdir 属性在 <html> 元素上,您可以使用useHead可组合函数来实现

App.vue
<script setup lang="ts">
import { computed } from 'vue'
import { useI18n } from 'vue-i18n'
import { useHead } from '@unhead/vue'
import * as locales from '@nuxt/ui/locale'

const { locale } = useI18n()

const lang = computed(() => locales[locale.value].code)
const dir = computed(() => locales[locale.value].dir)

useHead({
  htmlAttrs: {
    lang,
    dir
  }
})
</script>

<template>
  <UApp :locale="locales[locale]">
    <RouterView />
  </UApp>
</template>

支持的语言

默认情况下,使用 en 语言环境。

🇸🇦
العربية
代码: ar
🇦🇿
Azərbaycanca
代码: az
🇧🇬
Български
代码: bg
🇧🇩
বাংলা
代码: bn
🇪🇸
Català
代码: ca
🇮🇶
کوردی
代码: ckb
🇨🇿
Čeština
代码: cs
🇩🇰
Danish
代码: da
🇩🇪
Deutsch
代码: de
🇨🇭
Schweizerdeutsch
代码: de-CH
🇬🇷
Ελληνικά
代码: el
🇬🇧
英语
代码: en
🇪🇸
Español
代码: es
🇪🇪
Eesti
代码: et
🇮🇷
فارسی
代码: fa-IR
🇫🇮
Suomeksi
代码: fi
🇫🇷
Français
代码: fr
🇮🇱
Hebrew
代码: he
🇮🇳
Hindi
代码: hi
🇭🇷
Hrvatski
代码: hr
🇭🇺
Magyar
代码: hu
🇦🇲
Հայերեն
代码: hy
🇮🇩
Bahasa Indonesia
代码: id
🇮🇹
Italiano
代码: it
🇯🇵
日本語
代码: ja
🇬🇪
ქართული
代码: ka
🇰🇿
Қазақша
代码: kk
🇰🇭
ភាសាខ្មែរ
代码: km
🇰🇷
한국어
代码: ko
🇰🇬
Кыргызча
代码: ky
🇱🇺
Lëtzebuergesch
代码: lb
🇱🇹
Lietuvių
代码: lt
🇲🇳
Монгол
代码: mn
🇲🇾
Melayu
代码: ms
🇳🇴
Norsk Bokmål
代码: nb-NO
🇳🇱
Nederlands
代码: nl
🇵🇱
Polski
代码: pl
🇵🇹
Português
代码: pt
🇧🇷
Português (Brasil)
代码: pt-BR
🇷🇴
Română
代码: ro
🇷🇺
Русский
代码: ru
🇸🇰
Slovenčina
代码: sk
🇸🇮
Slovenščina
代码: sl
🇸🇪
Svenska
代码: sv
🇹🇭
ไทย
代码: th
🇹🇯
Тоҷикӣ
代码: tj
🇹🇷
Türkçe
代码: tr
🇨🇳
ئۇيغۇرچە
代码: ug-CN
🇺🇦
Українська
代码: uk
🇵🇰
Urdu
代码: ur
🇺🇿
Oʻzbek
代码: uz
🇻🇳
Tiếng Việt
代码: vi
🇨🇳
简体中文
代码: zh-CN
🇹🇼
繁體中文
代码: zh-TW
如果您需要额外的语言,可以通过创建 PR 在 src/runtime/locale/ 中添加新的语言环境来贡献。
您可以使用 nuxt-ui CLI 创建新的语言环境。
nuxt-ui make locale --code "en" --name "English"