CodeWF.Avalonia.Controls 12.1.4.11

CodeWF.Avalonia

面向 Avalonia 12 的 UI 控件与能力库合集：基础自定义控件、表格增强、Dock 布局、Markdown 渲染与编辑、国际化、日志查看，均以 CodeWF.Avalonia.* 前缀发布，XAML 命名空间统一挂 https://codewf.com。

A suite of UI control and capability libraries for Avalonia 12, published with the CodeWF.Avalonia.* prefix and a unified XAML namespace https://codewf.com.

版本号前三位跟随 Avalonia（当前 12.1.4），第四位为本仓修订号。

这个仓库解决什么 / What it solves

包一览 / Packages

「依赖」列只列第三方与本仓包依赖；所有包均面向 net10.0（Lang.Generator 为 netstandard2.0）。只有 4 个包直接依赖 Semi.Avalonia。

从 12.1.4.11 起，国际化的 JSON/XML/RESX 解析、文化回退与全局状态由 NuGet 包 CodeWF.Toolkit.Lang 提供，无需获取另一个仓库源码。CodeWF.Avalonia.Lang 保留 XAML 绑定和旧接口兼容层，两种命名空间的管理器共用同一状态；已有应用可继续使用原来的插件、自定义 ILangPlugin 和语言下拉框类型。控制台、服务及基础库直接安装 CodeWF.Toolkit.Lang，无需引入 Avalonia。

* 标注的依赖由对应包经传递引用带入，无需单独安装；它们本身不依赖 Semi，见 主题与依赖。

快速开始 / Quick start

# 最小可用：控件 + 官方 DataGrid 增强
dotnet add package CodeWF.Avalonia.Controls
dotnet add package CodeWF.Avalonia.DataGrid

App.axaml（注意 xmlns:semi，缺少它 <semi:SemiTheme/> 无法解析）：

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:semi="https://irihi.tech/semi"
             xmlns:codewf="https://codewf.com">
  
  <Application.Styles>
    
    <semi:SemiTheme Locale="zh-CN" />
    
    <codewf:ACSemiTheme />
    
    <codewf:DataGridSemiTheme />
  </Application.Styles>
</Application>

上面三行按需增删即可，下面是几种常见的最小组合：

主题与依赖 / Themes and dependencies

六个主题入口分别属于哪个包、是否依赖 Semi、能否省略：

6 套色板与 RequestedThemeVariant 的对应关系（演示应用还提供三套 Studio 配色，见下文）：

运行时切换只需给 Application.Current.RequestedThemeVariant 赋值：

Application.Current!.RequestedThemeVariant = ThemeVariant.Dark;          // Default 色板 · 深色
Application.Current!.RequestedThemeVariant = SemiTheme.Aquatic;          // 水生
Application.Current!.RequestedThemeVariant = CodeWFLogTheme.HighContrast; // 高对比

改色时的两个事实

• CodeWFLogTheme 是 sealed：它只能整体引入，不支持继承后覆盖配色。若需要自定义日志配色，请在应用资源里覆盖同名画笔键（Application.Resources 的优先级高于主题）。
• MarkdownThemes 可以继承：它是 public 无参构造的 Styles，MarkdownFullThemes 就是这么来的；排版主题/尺寸也支持运行时切换：

public class MyMarkdownThemes : MarkdownThemes
{
    public MyMarkdownThemes()
    {
        TypographyTheme = MarkdownTypographyThemes.TechnologyBlue; // 默认 Basic
        TypographySize = MarkdownTypographySizes.Small;            // 默认 Normal
    }
}

<codewf:MarkdownThemes TypographyTheme="TechnologyBlue" TypographySize="Small" />

排版主题共 18 套，Key 见 MarkdownTypographyThemes（Basic 为默认），尺寸见 MarkdownTypographySizes。

全局/局部切换还可调用 MarkdownThemes.OverrideTypographyResources(...)，无需重建控件。

注意：主题资源以程序集内绝对 URI（avares://CodeWF.Avalonia.*/Themes/...）引用，不要手动改写资源字典路径。

需要宿主自备的主题 / Host-provided theming

包 → 源码 → 文档索引 / Source & docs index

演示应用 / Demo

Demo 保留 Ribbon + Dock，按输入与选择、反馈与引导、数据展示、布局与导航、Markdown、开发工具分类；每个主菜单对应一个具体控件或 API。首页先展示目录，组合工作流集中到“综合示例”。新增展开动画独立页，块编辑、平面表格增强与状态卡片提供具体用例。共享主题接口、MVVM 约定与截图检查见 原生演示台文档。

命令区进一步按状态、引导、表格、窗口、布局动效、Markdown 阅读 / 编辑 / 导出等用途分组。参数与演示优先展示，源码按需打开；长 API 名保持完整，窄窗口可横向滚动。仓库通过 global.json 选择稳定版 .NET 10 SDK。

The native overview offers live Markdown, natural sorting and Dock experiments. See the linked guide for optional Studio themes, localization and validation.

Windows x64 NativeAOT Demo：标题栏支持主题色圈与下拉同步切换，默认 .NET 紫，也提供 AI 极光与暖陶的深浅主题。首页目录包含 32 个页面，实验区按需展开；完整功能与验收范围见上面的文档。

# 桌面演示台：Ribbon 页签 + Dock 工作区（左导航 / 中文档 / 右属性面板 / 下日志），含 .NET 紫、AI 极光、AI 暖陶与原有六套 Semi 配色，支持深浅与双语切换
dotnet run --project demo/CodeWF.Avalonia.Demo -f net10.0

# 冒烟模式：逐页构建后逐色板渲染一遍再退出，退出码 0 表示全部页面构建 + 渲染通过（CI 使用）
dotnet run --project demo/CodeWF.Avalonia.Demo -f net10.0 -- --smoke

安装包由 GitHub Releases 提供（随 v* tag 构建）：Windows setup.exe / 便携 zip、Linux deb、macOS dmg，均附 .sha256 校验文件。

CI/CD 与版本策略 / CI and versioning

• ci.yml：dotnet build -c Release + dotnet test，外加 NativeAOT 发布并在 Windows 上运行 --smoke。
• publish-nuget.yml：推送 v* tag 时打包并发布 NuGet（Trusted Publishing）。
• release.yml：同一 tag 触发全平台演示应用发布（6 个 RID：win-x64/x86、linux-x64/arm64、osx-x64/arm64）。
• 版本号前三跟随 Avalonia，第四位为本仓修订，例如 v12.1.4.4。
• 变更记录见 UpdateLog.md。

许可与贡献 / License and contributing

MIT。Issue 与 PR 都欢迎，提交前请确保 dotnet build CodeWF.Avalonia.slnx -c Release 与 dotnet test 通过。