2017-03-12 15:20:25 +08:00
|
|
|
|
---
|
2023-08-04 19:27:38 +08:00
|
|
|
|
group:
|
|
|
|
|
title: 进阶使用
|
2023-11-30 17:19:57 +08:00
|
|
|
|
order: 5
|
2017-03-12 15:20:25 +08:00
|
|
|
|
title: 国际化
|
|
|
|
|
---
|
|
|
|
|
|
2017-10-10 10:04:03 +08:00
|
|
|
|
`antd` 目前的默认文案是英文,如果需要使用其他语言,可以参考下面的方案。
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
2019-07-24 10:34:55 +08:00
|
|
|
|
## ConfigProvider
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
2022-12-13 15:49:05 +08:00
|
|
|
|
antd 提供了一个 React 组件 [ConfigProvider](/components/config-provider-cn) 用于全局配置国际化文案。
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
|
|
|
|
```jsx
|
2022-10-26 14:38:54 +08:00
|
|
|
|
import zhCN from 'antd/locale/zh_CN';
|
2024-03-28 11:25:38 +08:00
|
|
|
|
// for date-picker i18n
|
|
|
|
|
import 'dayjs/locale/zh-cn';
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
|
|
|
|
return (
|
2019-07-24 10:34:55 +08:00
|
|
|
|
<ConfigProvider locale={zhCN}>
|
2017-03-12 15:20:25 +08:00
|
|
|
|
<App />
|
2019-07-24 10:34:55 +08:00
|
|
|
|
</ConfigProvider>
|
2017-03-12 15:20:25 +08:00
|
|
|
|
);
|
|
|
|
|
```
|
|
|
|
|
|
2019-07-24 10:34:55 +08:00
|
|
|
|
详细配置见:[ConfigProvider](/components/config-provider)。
|
2018-12-07 18:16:23 +08:00
|
|
|
|
|
2017-10-10 10:04:03 +08:00
|
|
|
|
注意:`zh_CN` 是文件名,以下表格也遵循同样的规则。
|
2017-06-15 17:50:33 +08:00
|
|
|
|
|
2017-03-12 15:20:25 +08:00
|
|
|
|
目前支持以下语言:
|
|
|
|
|
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 语言 | 文件名 |
|
|
|
|
|
| -------------------- | ------ |
|
|
|
|
|
| 阿拉伯语 | ar_EG |
|
|
|
|
|
| 阿塞拜疆语 | az_AZ |
|
|
|
|
|
| 保加利亚语 | bg_BG |
|
2021-07-05 10:58:48 +08:00
|
|
|
|
| 孟加拉语(孟加拉国) | bn_BD |
|
2020-10-09 21:37:07 +08:00
|
|
|
|
| 白俄罗斯语 | by_BY |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 加泰罗尼亚语 | ca_ES |
|
|
|
|
|
| 捷克语 | cs_CZ |
|
|
|
|
|
| 丹麦语 | da_DK |
|
|
|
|
|
| 德语 | de_DE |
|
|
|
|
|
| 希腊语 | el_GR |
|
|
|
|
|
| 英语 | en_GB |
|
|
|
|
|
| 英语(美式) | en_US |
|
|
|
|
|
| 西班牙语 | es_ES |
|
2022-12-09 15:04:08 +08:00
|
|
|
|
| 巴斯克语 | eu_ES |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 爱沙尼亚语 | et_EE |
|
|
|
|
|
| 波斯语 | fa_IR |
|
|
|
|
|
| 芬兰语 | fi_FI |
|
|
|
|
|
| 法语(比利时) | fr_BE |
|
2021-03-14 16:47:32 +08:00
|
|
|
|
| 法语(加拿大) | fr_CA |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 法语(法国) | fr_FR |
|
|
|
|
|
| 爱尔兰语 | ga_IE |
|
2020-08-21 18:26:36 +08:00
|
|
|
|
| 加利西亚语(西班牙) | gl_ES |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 希伯来语 | he_IL |
|
|
|
|
|
| 印地语 | hi_IN |
|
|
|
|
|
| 克罗地亚语 | hr_HR |
|
|
|
|
|
| 匈牙利语 | hu_HU |
|
|
|
|
|
| 亚美尼亚 | hy_AM |
|
|
|
|
|
| 印度尼西亚语 | id_ID |
|
|
|
|
|
| 意大利语 | it_IT |
|
|
|
|
|
| 冰岛语 | is_IS |
|
|
|
|
|
| 日语 | ja_JP |
|
2021-11-20 15:02:28 +08:00
|
|
|
|
| 格鲁吉亚语 | ka_GE |
|
|
|
|
|
| 高棉语 | km_KH |
|
2020-08-06 10:40:58 +08:00
|
|
|
|
| 北库尔德语 | kmr_IQ |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 卡纳达语 | kn_IN |
|
2020-11-07 16:04:44 +08:00
|
|
|
|
| 哈萨克语 | kk_KZ |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 韩语/朝鲜语 | ko_KR |
|
2020-08-21 22:11:44 +08:00
|
|
|
|
| 立陶宛语 | lt_LT |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 拉脱维亚语 | lv_LV |
|
|
|
|
|
| 马其顿语 | mk_MK |
|
2021-07-27 10:56:41 +08:00
|
|
|
|
| 马拉雅拉姆语 | ml_IN |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 蒙古语 | mn_MN |
|
|
|
|
|
| 马来语 (马来西亚) | ms_MY |
|
2023-09-03 01:09:17 +08:00
|
|
|
|
| 缅甸语 | my_MM |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 挪威语 | nb_NO |
|
|
|
|
|
| 尼泊尔语 | ne_NP |
|
|
|
|
|
| 荷兰语(比利时) | nl_BE |
|
|
|
|
|
| 荷兰语 | nl_NL |
|
|
|
|
|
| 波兰语 | pl_PL |
|
|
|
|
|
| 葡萄牙语(巴西) | pt_BR |
|
|
|
|
|
| 葡萄牙语 | pt_PT |
|
|
|
|
|
| 罗马尼亚语 | ro_RO |
|
|
|
|
|
| 俄罗斯语 | ru_RU |
|
2022-06-22 19:38:21 +08:00
|
|
|
|
| 僧伽罗语 | si_LK |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 斯洛伐克语 | sk_SK |
|
|
|
|
|
| 塞尔维亚语 | sr_RS |
|
|
|
|
|
| 斯洛文尼亚语 | sl_SI |
|
|
|
|
|
| 瑞典语 | sv_SE |
|
|
|
|
|
| 泰米尔语 | ta_IN |
|
|
|
|
|
| 泰语 | th_TH |
|
|
|
|
|
| 土耳其语 | tr_TR |
|
2022-05-18 11:20:53 +08:00
|
|
|
|
| 土库曼 | tk_TK |
|
2021-07-13 10:02:21 +08:00
|
|
|
|
| 乌尔都语 (巴基斯坦) | ur_PK |
|
2020-07-21 23:08:55 +08:00
|
|
|
|
| 乌克兰语 | uk_UA |
|
|
|
|
|
| 越南语 | vi_VN |
|
|
|
|
|
| 简体中文 | zh_CN |
|
|
|
|
|
| 繁体中文(中国香港) | zh_HK |
|
|
|
|
|
| 繁体中文(中国台湾) | zh_TW |
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
2022-12-13 15:49:05 +08:00
|
|
|
|
具体的使用方法请参考 [ConfigProvider 文档](/components/config-provider-cn)。
|
2020-05-27 20:05:13 +08:00
|
|
|
|
|
|
|
|
|
## 增加语言包
|
|
|
|
|
|
2023-01-29 00:28:59 +08:00
|
|
|
|
如果你找不到你需要的语言包,欢迎你在 [英文语言包](https://github.com/ant-design/ant-design/blob/master/components/locale/en_US.ts) 的基础上创建一个新的语言包,并给我们发一个 Pull Request,可以参考 [阿塞拜疆语的 PR](https://github.com/ant-design/ant-design/pull/21387)。
|
2017-03-12 15:20:25 +08:00
|
|
|
|
|
2022-01-21 13:53:52 +08:00
|
|
|
|
基本步骤如下:
|
|
|
|
|
|
|
|
|
|
1. Fork `antd` 并 git clone 到本地,切换到 `feature` 分支,执行一次拉取确保最新,基于 `feature` 分支切换一个新分支,以下工作将在新分支完成。
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
git clone git@github.com:<your organization>/ant-design.git
|
|
|
|
|
cd ant-design/
|
2023-03-21 10:45:50 +08:00
|
|
|
|
git remote add upstream git@github.com:ant-design/ant-design.git
|
|
|
|
|
git checkout -b <your new branch name> upstream/feature
|
2022-01-21 13:53:52 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
2. 为 [rc-picker](https://github.com/react-component/picker) 添加对应语言,参考 [这个](https://github.com/react-component/picker/blob/master/src/locale/en_US.ts)。
|
|
|
|
|
3. 为 [rc-pagination](https://github.com/react-component/pagination) 添加对应语言,参考 [这个](https://github.com/react-component/pagination/blob/master/src/locale/en_US.js)。
|
|
|
|
|
4. 等待 `rc-picker` 和 `rc-pagination` 发布含上述内容的最低版本。
|
|
|
|
|
5. 参考 [阿塞拜疆语的 PR](https://github.com/ant-design/ant-design/pull/21387) 向 `antd` 发起 PR,完善对应语言的其他内容和更新 `rc-picker` 和 `rc-pagination` 版本。
|
2022-12-09 15:04:08 +08:00
|
|
|
|
6. 在 [index.test.tsx](https://github.com/ant-design/ant-design/blob/master/components/locale-provider/__tests__/index.test.tsx) 添加该语言的测试用例。
|
2022-01-21 13:53:52 +08:00
|
|
|
|
7. 更新 snapshot,在这之前或许你还需要先删除 `node_modules` 和 lock 文件 (`yarn.lock` or `package-lock.json`) 并全新安装。
|
|
|
|
|
|
|
|
|
|
```bash
|
2022-12-09 15:04:08 +08:00
|
|
|
|
npm run test -- components/locale -u
|
2022-01-21 13:53:52 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
8. 更新 [docs/react/i18n.zh-CN.md](https://github.com/ant-design/ant-design/blob/master/docs/react/i18n.zh-CN.md) 和 [docs/react/i18n.zh-CN.md](https://github.com/ant-design/ant-design/blob/master/docs/react/i18n.zh-CN.md),将对应语言添加到文档列表。
|
|
|
|
|
9. 观察 CI 是否通过,若未通过,根据日志进行修改直至通过。
|
|
|
|
|
10. 万事俱备等待 review 。
|
|
|
|
|
|
2017-03-12 15:20:25 +08:00
|
|
|
|
## i18n 项目示例
|
|
|
|
|
|
2020-05-27 19:53:29 +08:00
|
|
|
|
你可以参考 [Ant Design Pro 国际化文档](https://pro.ant.design/docs/i18n-cn) 查看完整的国际化项目示例。
|