Skip to main content

Vue i18n: Persediaan Pengantarabangsaan Lengkap dengan vue-i18n

Daripada pemasangan hingga pengeluaran: konfigurasikan vue-i18n dengan Composition API, kendalikan bentuk jamak dengan peraturan CLDR, gunakan interpolasi komponen, dan tambahkan rantaian sandaran lokal pintar.

1

Pasang vue-i18n

vue-i18n ialah pemalam pengantarabangsaan rasmi untuk Vue.js. Pemalam ini menyediakan terjemahan reaktif, bentuk jamak bergaya ICU, interpolasi komponen, pemformatan tarikh/masa dan nombor, serta sokongan Options API dan Composition API.

Terminal
npm install vue-i18n@9
2

Konfigurasikan vue-i18n

Cipta tika i18n dengan createI18n() dan daftarkannya sebagai pemalam Vue. Takrifkan mesej lokal, tetapkan lokal lalai, dan konfigurasikan lokal sandaran. vue-i18n menyokong mod legacy (Options API) dan composition (Composition API).

src/i18n.ts
// src/i18n.ts
import { createI18n } from 'vue-i18n'
import en from './locales/en.json'
import de from './locales/de.json'

const i18n = createI18n({
  legacy: false,           // Use Composition API mode
  locale: 'en',            // Default locale
  fallbackLocale: 'en',   // Fallback locale
  messages: { en, de },
})

export default i18n
src/main.ts
// src/main.ts
import { createApp } from 'vue'
import App from './App.vue'
import i18n from './i18n'

const app = createApp(App)
app.use(i18n)
app.mount('#app')
Jika anda melihat ralat 'Not available in legacy mode', anda mencampurkan panggilan i18n Composition API (useI18n()) dengan konfigurasi mod legacy. Tetapkan legacy: false dalam createI18n() untuk menggunakan mod Composition API, atau gunakan sintaks $t() Options API secara konsisten.
3

Gunakan Terjemahan dalam Templat

vue-i18n menyediakan fungsi $t() dalam templat (Options API) dan fungsi t() daripada useI18n() (Composition API). Kedua-duanya menerima kekunci terjemahan dan parameter bernama/senarai pilihan untuk interpolasi.

src/locales/en.json
// src/locales/en.json
{
  "nav": {
    "home": "Home",
    "about": "About",
    "settings": "Settings"
  },
  "greeting": "Hello, {name}!",
  "cart": {
    "itemCount": "no items | one item | {count} items"
  }
}

// src/locales/de.json
{
  "nav": {
    "home": "Startseite",
    "about": "Über uns",
    "settings": "Einstellungen"
  },
  "greeting": "Hallo, {name}!",
  "cart": {
    "itemCount": "keine Artikel | ein Artikel | {count} Artikel"
  }
}
4

Kendalikan Bentuk Jamak

vue-i18n menyokong bentuk jamak melalui bentuk yang dipisahkan tanda paip dan fungsi $tc() (legacy) atau t() dengan parameter count (Composition API). Takrifkan bentuk jamak dalam mesej lokal menggunakan pemisah tanda paip: 'no items | one item | {count} items'.

MyComponent.vue
<template>
  <div>
    <!-- Simple translation -->
    <h1>{{ $t('nav.home') }}</h1>

    <!-- With variables -->
    <p>{{ $t('greeting', { name: userName }) }}</p>

    <!-- In attributes -->
    <input :placeholder="$t('nav.settings')" />

    <!-- Composition API -->
    <p>{{ greeting }}</p>
  </div>
</template>

<script setup lang="ts">
import { useI18n } from 'vue-i18n'

const { t } = useI18n()
const userName = 'Alice'
const greeting = t('greeting', { name: userName })
</script>
Sintaks bentuk jamak yang dipisahkan tanda paip hanya menyokong bentuk jamak kardinal sehingga tiga bentuk (zero | one | other). Untuk bahasa dengan peraturan bentuk jamak CLDR kompleks (Arab, Rusia, Poland), gunakan sintaks ICU MessageFormat atau pengubah suai @.plural dengan pemetaan kategori CLDR jelas.
5

Tambahkan Rantaian Sandaran Lokal

fallbackLocale terbina dalam vue-i18n hanya menyokong senarai rata lokal sandaran, bukan rantaian bagi setiap lokal. Pengguna pt-BR dengan kekunci yang tiada bersandar kepada bahasa Inggeris dan bukannya pt-PT. vue-i18n-locale-chain menambahkan rantaian penggabungan mendalam boleh dikonfigurasikan supaya pengguna serantau sentiasa melihat terjemahan tersedia yang paling dekat.

Plurals.vue
<template>
  <div>
    <!-- Pipe-separated plurals -->
    <p>{{ $t('cart.itemCount', count) }}</p>

    <!-- Named plurals (recommended for complex languages) -->
    <p>{{ $t('orders', { n: orderCount }) }}</p>
  </div>
</template>

<!-- In your locale file: -->
<!-- "orders": "{n} order | {n} orders" -->
vue-i18n-locale-chain menggabungkan mesej secara mendalam semasa pemuatan. Set mesej gabungan dicache oleh sistem kereaktifan vue-i18n, maka tiada penalti prestasi masa jalan untuk carian sandaran.
6

Automatikkan Terjemahan

Selepas vue-i18n dikonfigurasikan, terjemahkan fail JSON lokal anda menggunakan AI. Daripada IDE, minta pembantu AI menterjemahkan fail sumber, atau sepadukan terjemahan ke dalam saluran CI/CD untuk penyetempatan automatik sepenuhnya.

LanguageSwitcher.vue
<template>
  <select v-model="locale">
    <option v-for="lang in availableLocales" :key="lang" :value="lang">
      {{ lang }}
    </option>
  </select>
</template>

<script setup lang="ts">
import { useI18n } from 'vue-i18n'

const { locale, availableLocales } = useI18n()
</script>
src/i18n.ts (lazy loading)
// src/i18n.ts
import { createI18n } from 'vue-i18n'

const i18n = createI18n({
  legacy: false,
  locale: 'en',
  fallbackLocale: 'en',
  messages: {},
})

export async function loadLocale(locale: string) {
  const messages = await import(`./locales/${locale}.json`)
  i18n.global.setLocaleMessage(locale, messages.default)
  i18n.global.locale.value = locale
}

export default i18n
7

Konfigurasi Rantaian Sandaran Lokal

Konfigurasikan rantaian sandaran bagi setiap lokal supaya pengguna serantau melihat terjemahan tersedia yang paling dekat dan bukannya terus beralih kepada bahasa Inggeris. vue-i18n menyokong fallbackLocale bergaya objek untuk mentakrifkan rantaian bagi setiap lokal.

src/i18n.ts
// src/i18n.ts
import { createI18n } from 'vue-i18n'

const i18n = createI18n({
  legacy: false,
  locale: 'pt-BR',
  fallbackLocale: {
    'pt-BR': ['pt', 'en'],
    'zh-Hant-TW': ['zh-Hant', 'zh', 'en'],
    'es-419': ['es', 'en'],
    default: ['en'],
  },
  messages: {
    en: { /* ... */ },
    pt: { /* ... */ },
    'pt-BR': { /* ... */ },
  },
})
Objek fallbackLocale membolehkan anda mentakrifkan rantaian berbeza untuk lokal berbeza. Pengguna pt-BR bersandar kepada pt kemudian en, manakala pengguna zh-Hant-TW bersandar kepada zh-Hant, zh, kemudian en.

Kesilapan Umum

Mencampurkan Mod Legacy dan Composition API

Menggunakan useI18n() dengan legacy: true (lalai) menyebabkan ralat. Tetapkan legacy: false dalam createI18n() jika anda menggunakan Composition API, atau kekal menggunakan $t() dalam templat dengan Options API. Jangan mencampurkan kedua-dua mod dalam aplikasi yang sama.

Menggunakan v-html untuk Rentetan Terjemahan

Menggunakan v-html untuk memaparkan terjemahan yang mengandungi HTML menimbulkan risiko XSS jika nilai interpolasi datang daripada input pengguna. Gunakan komponen &lt;i18n-t&gt; untuk terjemahan dengan HTML atau komponen Vue terbenam — komponen ini selamat secara lalai dan menyokong pembenaman komponen reaktif.

Pengguna Serantau Melihat Bahasa Inggeris, Bukan Bahasa Induk

fallbackLocale milik vue-i18n ialah senarai rata, bukan rantaian bagi setiap lokal. pt-BR bersandar kepada apa sahaja dalam senarai (biasanya 'en') dan melangkaui pt-PT sepenuhnya. Gunakan vue-i18n-locale-chain untuk menambahkan sandaran serantau yang betul dengan penggabungan mendalam.

Cuba i18n Agent Sekarang

Lepaskan fail terjemahan anda di sini

JSON, YAML, PO, XML, CSV, Markdown, Properties

atau klik untuk semak imbas

Bahasa sasaran

Tidak perlu mendaftarAnggaran serta-merta

Soalan Lazim i18n Vue