ant-design/docs/react/i18n.en-US.md

102 lines
3.7 KiB
Markdown
Raw Normal View History

2017-03-12 15:20:25 +08:00
---
order: 10
2017-03-12 15:20:25 +08:00
title: Internationalization
---
2020-07-17 16:44:25 +08:00
The default language of `antd@2.x` is currently English. If you wish to use other languages, follow the instructions below.
2017-03-12 15:20:25 +08:00
## ConfigProvider
2017-03-12 15:20:25 +08:00
`antd` provides a React Component [ConfigProvider](/components/config-provider) for configuring antd locale text globally.
2017-03-12 15:20:25 +08:00
```jsx
import { ConfigProvider } from 'antd';
2020-10-26 11:57:37 +08:00
import frFR from 'antd/lib/locale/fr_FR';
2017-03-12 15:20:25 +08:00
return (
<ConfigProvider locale={frFR}>
2017-03-12 15:20:25 +08:00
<App />
</ConfigProvider>
2017-03-12 15:20:25 +08:00
);
```
2020-07-17 16:44:25 +08:00
You can see the complete configuration here: [ConfigProvider](/components/config-provider).
2018-12-07 18:16:23 +08:00
2020-07-17 16:44:25 +08:00
Note: `fr_FR` is the filename, the following table also follows the same rules.
2020-07-17 16:44:25 +08:00
The following languages are currently supported:
### Supported languages:
2017-03-12 15:20:25 +08:00
2020-05-10 17:16:44 +08:00
| Language | Filename |
| ------------------------ | -------- |
| Arabic | ar_EG |
| Azerbaijani | az_AZ |
| Bulgarian | bg_BG |
| Bangla (Bangladesh) | bn_BD |
| Belarusian | by_BY |
2020-05-10 17:16:44 +08:00
| Catalan | ca_ES |
| Czech | cs_CZ |
| Danish | da_DK |
| German | de_DE |
| Greek | el_GR |
| English (United Kingdom) | en_GB |
| English | en_US |
| Spanish | es_ES |
| Estonian | et_EE |
| Persian | fa_IR |
| Finnish | fi_FI |
| French (Belgium) | fr_BE |
2021-03-14 16:47:32 +08:00
| French (Canada) | fr_CA |
2020-05-10 17:16:44 +08:00
| French (France) | fr_FR |
| Irish (Ireland) | ga_IE |
| Galician (Spain) | gl_ES |
2020-05-10 17:16:44 +08:00
| Hebrew | he_IL |
| Hindi | hi_IN |
| Croatian | hr_HR |
| Hungarian | hu_HU |
| Armenian | hy_AM |
| Indonesian | id_ID |
| Italian | it_IT |
| Icelandic | is_IS |
| Japanese | ja_JP |
| Georgian | ka_GE |
2020-08-10 09:43:21 +08:00
| Kurdish (Kurmanji) | kmr_IQ |
2020-05-10 17:16:44 +08:00
| Kannada | kn_IN |
| Kazakh | kk_KZ |
2020-05-10 17:16:44 +08:00
| Korean | ko_KR |
| Lithuanian | lt_LT |
2020-05-10 17:16:44 +08:00
| Latvian | lv_LV |
| Macedonian | mk_MK |
| Malayalam (India) | ml_IN |
2020-05-10 17:16:44 +08:00
| Mongolian | mn_MN |
| Malay (Malaysia) | ms_MY |
| Norwegian | nb_NO |
| Nepal | ne_NP |
| Dutch (Belgium) | nl_BE |
| Dutch | nl_NL |
| Polish | pl_PL |
| Portuguese (Brazil) | pt_BR |
| Portuguese | pt_PT |
| Romanian | ro_RO |
| Russian | ru_RU |
| Slovak | sk_SK |
| Serbian | sr_RS |
| Slovenian | sl_SI |
| Swedish | sv_SE |
| Tamil | ta_IN |
| Thai | th_TH |
| Turkish | tr_TR |
| Urdu (Pakistan) | ur_PK |
2020-05-10 17:16:44 +08:00
| Ukrainian | uk_UA |
| Vietnamese | vi_VN |
| Chinese (Simplified) | zh_CN |
2020-07-21 23:08:55 +08:00
| Chinese (Traditional) | zh_HK |
2020-05-10 17:16:44 +08:00
| Chinese (Traditional) | zh_TW |
2017-03-12 15:20:25 +08:00
See more usage at [ConfigProvider](/components/config-provider).
2017-03-12 15:20:25 +08:00
## Adding new language
2017-03-12 15:20:25 +08:00
2020-07-17 16:44:25 +08:00
If your language is not in above list, feel free to create a locale package based on the [en_US](https://github.com/ant-design/ant-design/blob/master/components/locale/en_US.tsx) lanugage pack and send us a pull request. For reference, you can refer to the pull request of adding the [Azerbaijani](https://github.com/ant-design/ant-design/pull/21387) language as a sample.