Internationalization
Internationalization
- Ant Design of React
- v5.23.3Changelog
- Basic Usage
- Advanced
- Migration
- Other
The default language of antd is currently English. If you wish to use other languages, follow the instructions below.
antd provides a React Component ConfigProvider for configuring antd locale text globally.
import { ConfigProvider } from 'antd';import frFR from 'antd/locale/fr_FR';return (<ConfigProvider locale={frFR}><App /></ConfigProvider>);
You can see the complete configuration here: ConfigProvider.
Note: fr_FR is the filename, the following table also follows the same rules.
The following languages are currently supported:
| Language | Filename |
|---|---|
| Arabic | ar_EG |
| Azerbaijani | az_AZ |
| Bulgarian | bg_BG |
| Bangla (Bangladesh) | bn_BD |
| Belarusian | by_BY |
| 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 |
| Basque | eu_ES |
| Estonian | et_EE |
| Persian | fa_IR |
| Finnish | fi_FI |
| French (Belgium) | fr_BE |
| French (Canada) | fr_CA |
| French (France) | fr_FR |
| Irish (Ireland) | ga_IE |
| Galician (Spain) | gl_ES |
| 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 |
| Kurdish (Kurmanji) | kmr_IQ |
| Kannada | kn_IN |
| Kazakh | kk_KZ |
| Khmer | km_KH |
| Korean | ko_KR |
| Lithuanian | lt_LT |
| Latvian | lv_LV |
| Macedonian | mk_MK |
| Malayalam (India) | ml_IN |
| Mongolian | mn_MN |
| Malay (Malaysia) | ms_MY |
| Burmese | my_MM |
| Norwegian | nb_NO |
| Nepali | 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 |
| Sinhalese / Sinhala | si_LK |
| Slovak | sk_SK |
| Serbian | sr_RS |
| Slovenian | sl_SI |
| Swedish | sv_SE |
| Tamil | ta_IN |
| Thai | th_TH |
| Turkish | tr_TR |
| Turkmen | tk_TK |
| Urdu (Pakistan) | ur_PK |
| Ukrainian | uk_UA |
| Uzbek(latn) | uz_UZ |
| Vietnamese | vi_VN |
| Chinese (Simplified) | zh_CN |
| Chinese (Traditional) | zh_HK |
| Chinese (Traditional) | zh_TW |
See more usage at ConfigProvider.
If your language is not in above list, feel free to create a locale package based on the en_US language pack and send us a pull request. For reference, you can refer to the pull request of adding the Azerbaijani language as a sample.
Do it step by step:
Fork antd and git clone to local, switch to feature branch, pull it to make sure it's up-to-date, create a new branch based on feature branch, all work will be done in it.
git clone git@github.com:<your organization>/ant-design.gitcd ant-design/git remote add upstream git@github.com:ant-design/ant-design.gitgit checkout -b <your new branch name> upstream/feature
Add the language support for rc-pagination, for example this.
Wait for rc-picker and rc-pagination to release the new version containing the above.
Update the rc-picker and rc-pagination versions in antd and add the remaining other necessary content for the language. for example Azerbaijani PR.
Add a test case for the language in index.test.tsx.
update snapshots, you may also need to delete node_modules, lock files (yarn.lock or package-lock.json) and reinstall at first.
npm run test -- components/locale -u
Add the language to i18n list docs/react/i18n.en-US.md and docs/react/i18n.zh-CN.md.
Watch out the CI status, and if it failed, look at the logs and make some changes until it all passes.
Ok, now everything is ready for review.