mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-14 09:20:51 +08:00
229 lines
5.9 KiB
Markdown
229 lines
5.9 KiB
Markdown
## Internacionalización
|
|
|
|
El idioma predeterminado de Element Plus es el inglés. Si se desea utilizar otro idioma, será necesario realizar alguna configuración de i18n. En su fichero de entrada, si está importando Element Plus por completo:
|
|
|
|
```javascript
|
|
import { createApp } from 'vue'
|
|
import ElementPlus from 'element-plus'
|
|
import locale from 'element-plus/lib/locale/lang/es'
|
|
|
|
createApp(App).use(ElementPlus, { locale })
|
|
```
|
|
|
|
O si está importando Element Plus a petición:
|
|
|
|
```javascript
|
|
import Vue from 'vue'
|
|
import { ElButton, ElSelect } from 'element-plus'
|
|
import lang from 'element-plus/lib/locale/lang/es'
|
|
import locale from 'element-plus/lib/locale'
|
|
|
|
// configure language
|
|
locale.use(lang)
|
|
|
|
// import components
|
|
Vue.component(ElButton.name, ElButton)
|
|
Vue.component(ElSelect.name, ElSelect)
|
|
```
|
|
|
|
El paquete de idioma inglés se importa por defecto, incluso si se esta usando otro idioma. Pero con `NormalModuleReplacementPlugin` proporcionado por el webpack puede reemplazar la localización predeterminada:
|
|
|
|
webpack.config.js
|
|
```javascript
|
|
{
|
|
plugins: [
|
|
new webpack.NormalModuleReplacementPlugin(/element-plus[\/\\]lib[\/\\]locale[\/\\]lang[\/\\]en/, 'element-plus/lib/locale/lang/es')
|
|
]
|
|
}
|
|
```
|
|
|
|
## Compatible con `vue-i18n@5.x`
|
|
|
|
Element Plus es compatible con [vue-i18n@5.x](https://github.com/kazupon/vue-i18n), lo que facilita aún más la conmutación multilenguaje.
|
|
|
|
```javascript
|
|
import Vue from 'vue'
|
|
import VueI18n from 'vue-i18n'
|
|
import ElementPlus from 'element-plus'
|
|
import enLocale from 'element-plus/lib/locale/lang/en'
|
|
import zhLocale from 'element-plus/lib/locale/lang/zh-cn'
|
|
import App from './App.vue';
|
|
|
|
const app = createApp(App)
|
|
app.use(ElementPlus)
|
|
Vue.use(VueI18n)
|
|
|
|
Vue.config.lang = 'zh-cn'
|
|
Vue.locale('zh-cn', zhLocale)
|
|
Vue.locale('en', enLocale)
|
|
```
|
|
|
|
## Compatible con otros plugins i18n
|
|
Es posible que Element Plus no sea compatible con otros plugins i18n que no sean vue-i18n, pero puede personalizar la forma en que Element Plus procesa i18n.
|
|
|
|
```javascript
|
|
import Vue from 'vue'
|
|
import ElementPlus from 'element-plus'
|
|
import enLocale from 'element-plus/lib/locale/lang/en'
|
|
import zhLocale from 'element-plus/lib/locale/lang/zh-cn'
|
|
|
|
Vue.use(Element, {
|
|
i18n: function (path, options) {
|
|
// ...
|
|
}
|
|
})
|
|
```
|
|
|
|
## Compatible con `vue-i18n@6.x`
|
|
|
|
Necesita manejarlo manualmente para ser compatible con `6.x`.
|
|
|
|
```javascript
|
|
import Vue from 'vue'
|
|
import ElementPlus from 'element-plus'
|
|
import VueI18n from 'vue-i18n'
|
|
import enLocale from 'element-plus/lib/locale/lang/en'
|
|
import zhLocale from 'element-plus/lib/locale/lang/zh-cn'
|
|
|
|
Vue.use(VueI18n)
|
|
|
|
const messages = {
|
|
en: {
|
|
message: 'hello',
|
|
...enLocale // Or use `Object.assign({ message: 'hello' }, enLocale)`
|
|
},
|
|
zh: {
|
|
message: '你好',
|
|
...zhLocale // Or use `Object.assign({ message: '你好' }, zhLocale)`
|
|
}
|
|
}
|
|
// Create VueI18n instance with options
|
|
const i18n = new VueI18n({
|
|
locale: 'en', // set locale
|
|
messages, // set locale messages
|
|
})
|
|
|
|
Vue.use(Element, {
|
|
i18n: (key, value) => i18n.t(key, value)
|
|
})
|
|
|
|
new Vue({ i18n }).$mount('#app')
|
|
```
|
|
|
|
## Personalización de i18n en componentes bajo petición
|
|
|
|
```js
|
|
import Vue from 'vue'
|
|
import DatePicker from 'element/lib/date-picker'
|
|
import VueI18n from 'vue-i18n'
|
|
|
|
import enLocale from 'element-plus/lib/locale/lang/en'
|
|
import zhLocale from 'element-plus/lib/locale/lang/zh-cn'
|
|
import ElementLocale from 'element-plus/lib/locale'
|
|
|
|
Vue.use(VueI18n)
|
|
Vue.use(DatePicker)
|
|
|
|
const messages = {
|
|
en: {
|
|
message: 'hello',
|
|
...enLocale
|
|
},
|
|
zh: {
|
|
message: '你好',
|
|
...zhLocale
|
|
}
|
|
}
|
|
// Create VueI18n instance with options
|
|
const i18n = new VueI18n({
|
|
locale: 'en', // set locale
|
|
messages, // set locale messages
|
|
})
|
|
|
|
ElementLocale.i18n((key, value) => i18n.t(key, value))
|
|
```
|
|
|
|
## Importar via CDN
|
|
|
|
```html
|
|
<script src="//unpkg.com/vue"></script>
|
|
<script src="//unpkg.com/element-plus"></script>
|
|
<script src="//unpkg.com/element-plus/lib/umd/locale/en.js"></script>
|
|
|
|
<script>
|
|
ELEMENT.locale(ELEMENT.lang.en)
|
|
</script>
|
|
```
|
|
|
|
Compatible con `vue-i18n`
|
|
|
|
```html
|
|
<script src="//unpkg.com/vue"></script>
|
|
<script src="//unpkg.com/vue-i18n/dist/vue-i18n.js"></script>
|
|
<script src="//unpkg.com/element-plus"></script>
|
|
<script src="//unpkg.com/element-plus/lib/umd/locale/zh-cn.js"></script>
|
|
<script src="//unpkg.com/element-plus/lib/umd/locale/en.js"></script>
|
|
|
|
<script>
|
|
Vue.locale('en', ELEMENT.lang.en)
|
|
Vue.locale('zh-cn', ELEMENT.lang.zhCN)
|
|
</script>
|
|
```
|
|
|
|
Actualmente Element Plus está disponible en los siguientes idiomas:
|
|
<ul class="language-list">
|
|
<li>Simplified Chinese (zh-cn)</li>
|
|
<li>English (en)</li>
|
|
<li>German (de)</li>
|
|
<li>Portuguese (pt)</li>
|
|
<li>Spanish (es)</li>
|
|
<li>Danish (da)</li>
|
|
<li>French (fr)</li>
|
|
<li>Norwegian (nb-NO)</li>
|
|
<li>Traditional Chinese (zh-tw)</li>
|
|
<li>Italian (it)</li>
|
|
<li>Korean (ko)</li>
|
|
<li>Japanese (ja)</li>
|
|
<li>Dutch (nl)</li>
|
|
<li>Vietnamese (vi)</li>
|
|
<li>Russian (ru)</li>
|
|
<li>Turkish (tr)</li>
|
|
<li>Brazilian Portuguese (pt-br)</li>
|
|
<li>Farsi (fa)</li>
|
|
<li>Thai (th)</li>
|
|
<li>Indonesian (id)</li>
|
|
<li>Bulgarian (bg)</li>
|
|
<li>Polish (pl)</li>
|
|
<li>Finnish (fi)</li>
|
|
<li>Swedish (sv)</li>
|
|
<li>Greek (el)</li>
|
|
<li>Slovak (sk)</li>
|
|
<li>Catalunya (ca)</li>
|
|
<li>Czech (cs)</li>
|
|
<li>Ukrainian (uk)</li>
|
|
<li>Turkmen (tk)</li>
|
|
<li>Tamil (ta)</li>
|
|
<li>Latvian (lv)</li>
|
|
<li>Afrikaans (af)</li>
|
|
<li>Estonian (et)</li>
|
|
<li>Slovenian (sl)</li>
|
|
<li>Arabic (ar)</li>
|
|
<li>Hebrew (he)</li>
|
|
<li>Lithuanian (lt)</li>
|
|
<li>Mongolian (mn)</li>
|
|
<li>Kazakh (kk)</li>
|
|
<li>Hungarian (hu)</li>
|
|
<li>Romanian (ro)</li>
|
|
<li>Kurdish (ku)</li>
|
|
<li>Uighur (ug-cn)</li>
|
|
<li>Khmer (km)</li>
|
|
<li>Serbian (sr)</li>
|
|
<li>Basque (eu)</li>
|
|
<li>Kyrgyz (ky)</li>
|
|
<li>Armenian (hy-am)</li>
|
|
<li>Croatian (hr)</li>
|
|
<li>Esperanto (eo)</li>
|
|
</ul>
|
|
|
|
Si su idioma de destino no está incluido, puede contribuir: simplemente añada [aqui](https://github.com/element-plus/element-plus/tree/dev/packages/locale/lang) otra configuración de idioma y cree un pull request.
|