国际化

国际化是指组件库内置的适应国际上主要地区语言的默认配置，包括文本翻译和日期格式，以及一些组件的默认配置，如日期组件中配置一周的第一天是星期几、月份是否在年份前面等等。

Ant Design Blazor 的国际化由内置的 LocaleProvider 静态类来提供，可对不同 UI 线程设置该线程的区域语言包，语言包内嵌在程序集中。

另外，我们还提供了站点级别的本地化组件，请参考本地化。

默认语言

组件默认会在程序调用 Services.AddAntDesign() 时自动从环境中获取区域语言作为默认语言。因此，不同的运行环境就有不同的设置：

• Blazor WebAssembly： 会从访问者的浏览器语言设置中获取默认语言。注意并不是从系统操作系统或服务端获取。
• Blazor 服务端静态/交互渲染： 会根据运行该服务的操作系统环境中的语言来作为默认语言，而不是根据用户的请求来设置。
• Blazor WebApp Auto 模式：则在静态阶段从服务器系统获取，在WebAssembly阶段从浏览器获取，因此需要注意保持语言一致，避免切换的问题。
• Blazor Hybrid 会从客户端中获取默认语言。

如果需要手动设置默认语言，可以在初始化时进行配置，也可以在运行中随时修改，请参考下面的方案。

全局配置

在应用运行的入口处设置

service.AddAntDesign();

// 设置默认语言
LocaleProvider.DefaultLanguage = "en-US";

运行时修改

@code {

    private void ChangeLocale()
    {
        LocaleProvider.SetLocale("en-US");
        StateHasChanged();
    }
}

语言包设置

当设置的语言没有内置的语言包时，我们会按照 父区域性 => 默认语言 => "en-US" 的顺序选择后备语言。(有关父区域性的概念解释，参见全球化和本地化术语，推荐阅读该页面的英语版本)

可以通过 LocaleProvider.DefaultLanguage = "languageName" 设置默认语言。

您也可以通过 LocaleProvider.SetLocale 方法添加语言包。

// 设置默认语言
LocaleProvider.DefaultLanguage = "en-US";

// 创建一个 `Locale` 对象
var zhHK = new Locale { ... };
// 设置额外的语言
LocaleProvider.SetLocale("zh-HK", zhHK); 

注意：en-US 是语言包名称，以下表格也遵循同样的规则。

内置语言

当然，我们并不精通所有的语言，如果你发现翻译有误，请提交 PR 帮助我们改进。