
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.
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.
npm install vue-i18n@9Konfigurasikan 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
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
import { createApp } from 'vue'
import App from './App.vue'
import i18n from './i18n'
const app = createApp(App)
app.use(i18n)
app.mount('#app')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
{
"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"
}
}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'.
<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>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.
<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" -->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.
<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
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 i18nKonfigurasi 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
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': { /* ... */ },
},
})Kesilapan Umum
Mencampurkan Mod Legacy dan Composition API
Menggunakan v-html untuk Rentetan Terjemahan
Pengguna Serantau Melihat Bahasa Inggeris, Bukan Bahasa Induk
Cuba i18n Agent Sekarang
Lepaskan fail terjemahan anda di sini
JSON, YAML, PO, XML, CSV, Markdown, Properties
atau klik untuk semak imbas
Bahasa sasaran