多语言

localization

功能概述

多语言模块支持系统界面在运行时动态切换语言,满足国际化需求。基于 BootstrapBlazor 的多语言机制实现,通过 CultureChooser 组件在界面右上角提供语言切换入口,切换后即时生效,无需重启系统。

使用方法

启用多语言

Program.cs 中配置:

builder.AddEasyAdminBlazor(new EasyAdminBlazorOptions
{
    EnableLocalization = true,
    ...
});

切换语言

在页面右上角的语言选择器中点击目标语言,系统立即切换界面语言。

添加新语言

无需修改代码,只需在语言资源文件中添加对应语言的翻译资源即可。BootstrapBlazor 会自动读取并展示可用语言选项。

配置说明

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 — 配置支持的语言列表