국제화
국제화 (Internationalization)
출처: 문서
본문
Element Plus 컴포넌트는 기본적으로 영어를 사용해요. 다른 언어를 쓰고 싶다면 이 문서를 계속 읽어 보세요.
전역 설정
Element Plus는 전역 설정 옵션을 제공해요.
main.ts
import ElementPlus from 'element-plus'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
app.use(ElementPlus, {
locale: zhCn,
})
ConfigProvider
Element Plus는 로케일과 그 외 설정을 전역으로 구성하기 위한 Vue 컴포넌트 ConfigProvider도 제공해요.
App.vue
<template>
<el-config-provider :locale="zhCn">
<!-- ... -->
</el-config-provider>
</template>
<script setup lang="ts">
import { ElConfigProvider } from 'element-plus'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
</script>
날짜·시간 로컬라이제이션
DatePicker 같은 컴포넌트에서 날짜와 시간을 다룰 때는 Day.js 라이브러리를 사용해요. 국제화가 제대로 동작하려면 Day.js에 적절한 로케일을 설정하는 게 중요해요. Day.js의 로케일 설정을 따로 import 해야 합니다.
import 'dayjs/locale/zh-cn'
CDN 사용
CDN으로 Element Plus를 사용한다면 아래와 같이 설정해야 해요. unpkg를 예로 들어 볼게요.
<script src="//unpkg.com/element-plus/dist/locale/zh-cn"></script>
<script>
app.use(ElementPlus, {
locale: ElementPlusLocaleZhCn,
})
</script>
자세한 문서는 ConfigProvider를 참고하세요.
지원 언어 목록
- Simplified Chinese (zh-cn)
- American English (en)
- Azerbaijani (az)
- German (de)
- Portuguese (pt)
- Spanish (es)
- Danish (da)
- French (fr)
- Norwegian (nb-NO)
- Traditional Chinese (zh-tw)
- Italian (it)
- Korean (ko)
- Japanese (ja)
- Dutch (nl)
- Vietnamese (vi)
- Russian (ru)
- Turkish (tr)
- Brazilian Portuguese (pt-br)
- Farsi (fa)
- Thai (th)
- Indonesian (id)
- Bulgarian (bg)
- Pashto (pa)
- Polish (pl)
- Finnish (fi)
- Swedish (sv)
- Greek (el)
- Slovak (sk)
- Catalunya (ca)
- Czech (cs)
- Ukrainian (uk)
- Turkmen (tk)
- Tamil (ta)
- Latvian (lv)
- Afrikaans (af)
- Estonian (et)
- Slovenian (sl)
- Arabic (ar)
- Hebrew (he)
- Lao (lo)
- Lithuanian (lt)
- Mongolian (mn)
- Kazakh (kk)
- Hungarian (hu)
- Romanian (ro)
- Kurdish (ku)
- Kurdish (ckb)
- Uighur (ug-cn)
- Khmer (km)
- Serbian (sr)
- Basque (eu)
- Kyrgyz (ky)
- Armenian (hy-am)
- Croatian (hr)
- Esperanto (eo)
- Bengali (bn)
- Malay (ms)
- Madagascar (mg)
- Swahili (sw)
- Uzbek (uz-uz)
- Egyptian Arabic (ar-eg)
- Burmese (my)
- Hindi (hi)
- Norsk (no)
- Hongkong Chinese (zh-hk)
- Macau Chinese (zh-mo)
- Telugu (te)
다른 언어가 더 필요하다면 PR은 언제나 환영이에요. 여기에 언어 파일만 추가하면 되죠.