安装

⏱ 预计阅读 3 分钟适用于 net10.0 来源： CodeWF · docs/CodeWF.Avalonia.Controls 说明文档.md ✎ 在 GitHub 编辑此页

# CodeWF.Avalonia.Controls

基础自定义控件库，控件 API、状态模型、绘制逻辑与 Semi 主题资源在同一包内，安装即用。

安装

bash

dotnet add package CodeWF.Avalonia.Controls

主题接入

在 App.axaml 的 Styles 中引入（需先引入 Semi.Avalonia 主题）：

xml

<codewf:ACSemiTheme />

窗口类控件另有一个聚合主题入口 CodeWFTheme。主题资源按 Light / Dark / HighContrast 变体组织，跟随应用主题切换。

控件一览

控件	命名空间	说明
Guide / GuideOverlay / GuideStep	CodeWF.Avalonia.Controls.Controls	新手引导：多步骤高亮遮罩、指示器与箭头，支持缺省目标行为（GuideMissingTargetBehavior）
Transfer / SearchListBox	CodeWF.Avalonia.Controls.Controls	穿梭框与可搜索列表，支持左右栏自定义渲染
StatusBadge / StatusCard	CodeWF.Avalonia.Controls.Controls	状态徽标与状态卡片，内置多主题配色（StatusLabelKind）
CodeWFWindow / CodeWFTitleBar	CodeWF.Avalonia.Controls.Controls	统一标题栏窗口：DWM 圆角、图标与按钮定制，Windows 平台增强
WindowedStackPanel	CodeWF.Avalonia.Controls.Controls	窗口化虚拟化堆叠面板，长列表场景降低可视化树规模
TrapezoidShapedTabItem / TabStrip	CodeWF.Avalonia.Controls.Controls	梯形页签样式，边框绘制由 TrapezoidShapedTabItemBorder 承担
ColumnDisplayEditor	CodeWF.Avalonia.Controls.Controls	表格列显示配置编辑器，配合 ColumnDisplayItem 模型
ContentExpansionAnimator	CodeWF.Avalonia.Controls.Controls	内容展开/收起动效

XAML 中统一通过 https://codewf.com 命名空间使用：

xml

<Window xmlns="https://github.com/avaloniaui"
        xmlns:codewf="https://codewf.com">
  <codewf:StatusBadge Kind="Success" Content="运行中" />
</Window>

CodeWFWindow.TitleBarHeight 控制标题栏及窗口按钮的高度，CaptionButtonWidth 独立控制最小化、最大化和关闭按钮宽度（默认 32px）。两者支持运行时调整，例如 52px 标题栏配 34px 按钮，或 44×44px 的窗口按钮；宽度必须是有限正数。Demo 的 CodeWFWindow 页面通过文档属性面板配置下一次打开的示例窗口。

标记扩展

扩展	用法示例
IfExtension	`{codewf:If Condition={Binding IsBusy}, True='加载中', False='就绪'}`，条件/分支支持绑定与静态值混合
IfBinding	If 的多绑定形态，条件与分支均为 Binding 时使用
SwitchExtension / SwitchCase	`{codewf:Switch}` + `SwitchCase` 集合，多分支值切换

转换器

EnumToBooleanConverter、IsCollectionEmptyConverter、If/Switch 配套转换器（IfConditionConverter、IfConverter、SwitchConverter）均在 CodeWF.Avalonia.Controls.Converters 命名空间，可独立于标记扩展使用。

注意事项

目标框架 net10.0；控件默认启用编译期绑定（AvaloniaUseCompiledBindingsByDefault）。
主题资源引用本程序集内绝对 URI（avares://CodeWF.Avalonia.Controls/Themes/...），不要手动覆盖资源字典路径。
DWM 相关能力（WindowsDwmWindowCornerHelper）仅 Windows 生效，其余平台自动降级。