多语言

localization

功能概述

多语言用于切换系统界面语言。底层基于 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 — 配置支持的语言列表