Changelog

所有重要的版本更新都会记录在此文件中。

格式基于 Keep a Changelog，版本号遵循 语义化版本。

[1.3.0] - 2026-01-30

Added

  • 完整的国际化 (i18n) 支持

    • 新增 INextUILocalizer 接口，支持即时语言切换（无需页面刷新）
    • 新增 ILanguageProvider 接口，支持应用自定义语言列表
    • 新增 LanguageOption 记录类型，包含 RTL 语言支持
    • 新增 LocalizedComponentBase 基类，简化组件本地化开发
    • 新增 NextUIResources.cs，组件库内置 5 种语言翻译（en-US, zh-CN, zh-TW, ja-JP, ar）

  • 组件库内置翻译

    • SxSelect: 占位符、加载状态、无数据提示
    • SxDataGrid: 排序、筛选、列宽等所有交互文本
    • SxNavMenu: 筛选占位符、无障碍标签
    • SxNavBar: 首页、返回按钮文本
    • SxErrorBoundary: 错误恢复按钮文本
    • SxIconGallery: 分类、筛选等 UI 文本
    • SxUserBar: 设置、退出登录等菜单项
    • SxUserBarQuickSettings: 主题、语言切换面板

  • Workbench 国际化

    • 新增 WorkbenchResources.cs，包含 Workbench 全部 UI 翻译
    • 新增 WorkbenchLanguageProvider，支持 5 种语言

Fixed

  • SxTabs/SxTabPanel 语言切换问题
    • 修复：当父组件重新渲染时，Tab 标签不更新的问题
    • 新增 SxTabs.NotifyTabChanged() 方法
    • SxTabPanel 现在会检测 Label 变化并通知父组件

Changed

  • ServiceCollectionExtensions.AddNextDesignSystem() 现在会自动调用 NextUIResources.Initialize() 初始化组件库翻译
  • SxComponentPlayground 现在订阅语言变更事件，支持即时切换

Documentation

  • 新增 docs/LOCALIZATION.md，完整的国际化使用指南

[1.2.0] - 2026-01-10

Added

  • 初始版本的主题系统和设计变量支持
  • 核心组件库 (SxButton, SxInput, SxSelect, SxDataGrid 等)
  • Workbench 组件实验室
  • MAUI Hybrid 支持

升级指南

从 1.2.x 升级到 1.3.0

  1. 无破坏性变更 - 所有现有代码继续正常工作

  2. 启用组件库翻译 - 自动启用，无需额外操作

  3. 添加应用级翻译 (可选)：

    // 创建 MyAppResources.cs
public static class MyAppResources
{
    public static void Initialize()
    {
        NextUILocalizer.Add("en-US", "App.Title", "My App");
        NextUILocalizer.Add("zh-CN", "App.Title", "我的应用");
    }
}

// 在 Program.cs 中调用
MyAppResources.Initialize();

  4. 自定义语言列表 (可选)：

    builder.Services.AddSingleton<ILanguageProvider, MyLanguageProvider>();

© 2026 NextUI Team