Internationalization

The default language of antd@2.x is currently English. If you wish to use other languages, follow the instructions below.

ConfigProvider#

antd provides a React Component ConfigProvider for configuring antd locale text globally.

import { ConfigProvider } from 'antd';
import frFR from 'antd/es/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:

Supported languages:#

LanguageFilename
Arabicar_EG
Azerbaijaniaz_AZ
Bulgarianbg_BG
Bangla (Bangladesh)bn_BD
Belarusianby_BY
Catalanca_ES
Czechcs_CZ
Danishda_DK
Germande_DE
Greekel_GR
English (United Kingdom)en_GB
Englishen_US
Spanishes_ES
Estonianet_EE
Persianfa_IR
Finnishfi_FI
French (Belgium)fr_BE
French (Canada)fr_CA
French (France)fr_FR
Irish (Ireland)ga_IE
Galician (Spain)gl_ES
Hebrewhe_IL
Hindihi_IN
Croatianhr_HR
Hungarianhu_HU
Armenianhy_AM
Indonesianid_ID
Italianit_IT
Icelandicis_IS
Japaneseja_JP
Georgianka_GE
Kurdish (Kurmanji)kmr_IQ
Kannadakn_IN
Kazakhkk_KZ
Khmerkm_KH
Koreanko_KR
Lithuanianlt_LT
Latvianlv_LV
Macedonianmk_MK
Malayalam (India)ml_IN
Mongolianmn_MN
Malay (Malaysia)ms_MY
Norwegiannb_NO
Nepalne_NP
Dutch (Belgium)nl_BE
Dutchnl_NL
Polishpl_PL
Portuguese (Brazil)pt_BR
Portuguesept_PT
Romanianro_RO
Russianru_RU
Slovaksk_SK
Serbiansr_RS
Sloveniansl_SI
Swedishsv_SE
Tamilta_IN
Thaith_TH
Turkishtr_TR
Turkmentk_TK
Urdu (Pakistan)ur_PK
Ukrainianuk_UA
Vietnamesevi_VN
Chinese (Simplified)zh_CN
Chinese (Traditional)zh_HK
Chinese (Traditional)zh_TW

See more usage at ConfigProvider.

Adding new language#

If your language is not in above list, feel free to create a locale package based on the en_US lanugage 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:

  1. 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.git
cd ant-design/
git remote add upstream origin git@github.com:ant-design/ant-design.git
git checkout -b <your new branch name>

  2. Add the language support for rc-picker, for example this.

  3. Add the language support for rc-pagination, for example this.

  4. Wait for rc-picker and rc-pagination to release the new version containing the above.

  5. Update the rc-picker and rc-pagination versions in antd and add the remaining other necessary content for the language. for example Azerbaijani PR.

  6. Add a test case for the language in index.test.js.

  7. 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-provider -u

  8. Add the language to i18n list docs/react/i18n.en-US.md and docs/react/i18n.zh-CN.md.

  9. Watch out the CI status, and if it failed, look at the logs and make some changes until it all passes.

  10. Ok, now everything is ready for review.