多语言

功能概述
多语言用于切换系统界面语言。底层基于 BootstrapBlazor 的多语言机制,界面右上角是 CultureChooser 组件,选中后立即生效,不用重启。
使用方法
启用多语言
在 Program.cs 中配置:
builder.AddEasyAdminBlazor(new EasyAdminBlazorOptions
{
EnableLocalization = true,
...
});
切换语言
页面右上角有个语言选择器,点一下想用的语言,界面马上就切过去了。
添加新语言
不用改代码,在语言资源文件里加上对应语言的翻译就行。BootstrapBlazor 会自动识别并展示可用的语言选项。
语言包分为两处:
- 主语言包:
EasyAdminBlazor/Locales/{culture}.json,根节点EasyAdminBlazor.Common,放框架本身和多个扩展共用的文案; - 扩展语言包:
Extensions/EasyAdminBlazor.{扩展名}/Locales/{culture}.json,同样用EasyAdminBlazor.Common根节点,放该扩展独有的文案与实体字段块。扩展注册时调用AddEasyAdminBlazorAssembly,框架会自动把这些程序集加入JsonLocalizationOptions.AdditionalJsonAssemblies并合并进CommonLocalizer。本仓库根目录的Directory.Build.targets会自动嵌入Locales/*.json;独立项目需在 csproj 显式声明。
新增语言时两处都要补上;扩展没提供对应语言时会自动退回主语言包(再退回中文键本身)。
配置说明
if (options.EnableLocalization)
{
builder.Services.AddRequestLocalization<IOptionsMonitor<BootstrapBlazorOptions>>((localizerOption, blazorOption) =>
{
var supportedCultures = blazorOption.CurrentValue.GetSupportedCultures();
localizerOption.SupportedCultures = supportedCultures;
localizerOption.SupportedUICultures = supportedCultures;
});
}
相关组件/服务
CultureChooser— 语言切换 UI 组件CommonLocalizer— 本地化服务BootstrapBlazorOptions— 配置支持的语言列表