ant-design-blazor/docs/i18n.zh-CN.md
James Yeung 360fe0d3c0 fix(hosting): server prerendering issue (#583)
* refactor: rename JSInterop constants

* docs: fix typo

* fix: server prerendering issue
2020-09-09 00:52:14 +08:00

98 lines
3.0 KiB
Markdown

---
order: 4
title: 国际化
---
`Ant Design Blazor` 的国际化基于内建的 `LocaleProvider`,而本地化基于 Blazor 框架提供的 `CultureInfo.DefaultThreadCurrentUICulture`,可参考文档 [ASP.NET Core Blazor 全球化和本地化](https://docs.microsoft.com/zh-cn/aspnet/core/blazor/globalization-localization?view=aspnetcore-3.1#localization)。
默认会从浏览器获取本地语言,如果需要使用其他语言,可以在初始化时进行配置,也可以在运行中随时修改,请参考下面的方案。
## 全局配置
```csharp
// 设置当前语言
LocaleProvider.SetLocale("en-US");
```
## 运行时修改
`Ant Design Blazor` 可使用 `CultureInfo.DefaultThreadCurrentUICulture` 来动态修改国际化文案。
```csharp
// 在任何地方修改都可以切换当前线程的语言
CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.GetCultureInfo("en-US");
```
当设置的语言没有内置的语言包时,默认会被设置为"en-US"。也可以通过 `LocaleProvider.SetLocale` 方法添加。
```csharp
// 创建一个 `Locale` 对象
var zhHK = new Locale { ... };
// 设置额外的语言
LocaleProvider.SetLocale("zh-HK", zhHK);
```
注意:`en-US` 是语言包名称,以下表格也遵循同样的规则。
## 内置语言
| 语言 | 语言包名 |
| ---------------- | ------ |
| 阿拉伯 | ar-EG |
| 亞美尼亞 | hy-AM |
| 保加利亚语 | bg-BG |
| 加泰罗尼亚语 | ca-ES |
| 捷克语 | cs-CZ |
| 丹麦语 | da-DK |
| 德语 | de-DE |
| 希腊语 | el-GR |
| 英语 | en-GB |
| 英语(美式) | en-US |
| 西班牙语 | es-ES |
| 爱沙尼亚语 | et-EE |
| 波斯语 | fa-IR |
| 芬兰语 | fi-FI |
| 法语(比利时) | fr-BE |
| 法语 | fr-FR |
| 希伯来语 | he-IL |
| 印地语 | hi-IN |
| 克罗地亚语 | hr-HR |
| 匈牙利 | hu-HU |
| 冰岛语 | is-IS |
| 印度尼西亚语 | id-ID |
| 意大利语 | it-IT |
| 日语 | ja-JP |
| 格鲁吉亚语 | ka-GE |
| 卡纳达语 | kn-IN |
| 韩语/朝鲜语 | ko-KR |
| 库尔德语 | ku-IQ |
| 拉脱维亚语 | lv-LV |
| 马来语 | ms-MY |
| 蒙古语 | mn-MN |
| 挪威 | nb-NO |
| 尼泊尔语 | ne-NP |
| 荷兰语(比利时) | nl-BE |
| 荷兰语 | nl-NL |
| 波兰语 | pl-PL |
| 葡萄牙语(巴西) | pt-BR |
| 葡萄牙语 | pt-PT |
| 斯洛伐克语 | sk-SK |
| 塞尔维亚 | sr-RS |
| 斯洛文尼亚 | sl-SI |
| 瑞典语 | sv-SE |
| 泰米尔语 | ta-IN |
| 泰语 | th-TH |
| 土耳其语 | tr-TR |
| 罗马尼亚语 | ro-RO |
| 俄罗斯语 | ru-RU |
| 乌克兰语 | uk-UA |
| 越南语 | vi-VN |
| 简体中文 | zh-CN |
| 繁体中文 | zh-TW |