Astrea.Components
0.9.0
dotnet add package Astrea.Components --version 0.9.0
NuGet\Install-Package Astrea.Components -Version 0.9.0
<PackageReference Include="Astrea.Components" Version="0.9.0" />
<PackageVersion Include="Astrea.Components" Version="0.9.0" />
<PackageReference Include="Astrea.Components" />
paket add Astrea.Components --version 0.9.0
#r "nuget: Astrea.Components, 0.9.0"
#:package Astrea.Components@0.9.0
#addin nuget:?package=Astrea.Components&version=0.9.0
#tool nuget:?package=Astrea.Components&version=0.9.0
Astrea
English | 简体中文
Blazor UI components for .NET 10 — Tree and ResourceTable. · 面向 .NET 10 Blazor 应用的可复用组件库,当前交付 Tree 与 ResourceTable。
定位:在 .NET 10 上构建 Blazor Web App / standalone WebAssembly 应用,需要键盘可操作、状态可控的树形编辑器与列驱动资源表格的团队。
状态:已发布 0.9.0(目标 .NET 10,仅提供 net10.0 资产;GitHub Packages 由 release 工作流发布,nuget.org 需单独发布)。0.x 预览期,小版本可能包含已在 CHANGELOG 记录的破坏性变更;Active 组件仅 Tree 与 ResourceTable,其余 9 个为 Deferred。
在线演示 · 快速开始 · SRS · Roadmap · 更新日志 · 贡献指南
Astrea 是面向 .NET 10 的 Blazor 组件库,当前版本只交付两个组件:Tree(树形编辑器)与 ResourceTable(列驱动资源表格),其余 9 个规划组件标记为 Deferred,不属于当前发布契约。
Tree 支持多选、三态拖放与应用侧否决、F2 内联编辑、右键通知、受控/非受控选择与展开,以及固定行高虚拟化(演示页可生成 5 万节点)。
组件按 WAI-ARIA Tree View 模式实现单一 Tab 停靠点与 aria-activedescendant;发布的验证证据记录 Tree 与 ResourceTable 容器的 axe 审计为 0 个 serious/critical 违规。
当前版本范围
| 组件 | 状态 | SRS |
|---|---|---|
| Tree | Active | §3.10 |
| ResourceTable | Active | §3.12 |
| Button、Alert、Divider、Input、Label、Modal、Progress、Select、Table | Deferred | 附录 B / Roadmap |
演示站
Blazor WebAssembly 演示以 GitHub Pages 项目站点发布:https://hestialab.github.io/Astrea/。部署工作流会把 <base href> 改写为 /Astrea/,并把改写后的 index.html 复制为 404.html,因此直接访问链接或刷新时仍能进入 Blazor 路由。
应用内所有链接必须保持相对于 <base> 路径(例如 components/tree;目录首页使用空 href)。不要使用 /components/tree 这类根绝对路径,它会解析到项目站点之外。推送到 main 或 dev 会自动部署;也可以使用 Deploy demo to GitHub Pages 工作流的 workflow_dispatch 手动重新部署。
Tree 功能
- 多选 — Ctrl 切换选中;Shift 范围选择可以跨同一 Tree 的根边界,拒绝禁用端点并跳过禁用中间节点。键盘:Space 切换焦点节点;Shift+方向键/Home/End 从键盘锚点扩展范围。
- 拖放 —
before/inside/after三种放置位置;支持应用侧否决;内置拒绝自引用、跨树、成环、过期操作与重复完成。 - 内联编辑 — F2 进入,Enter 提交,Esc 取消;支持
BeforeRename否决。 - 右键菜单通知 — Tree 只通知(节点 + 位置);菜单由应用渲染,且不改变选中或焦点。
- ARIA 键盘导航 — 方向键 / Home / End / Space / Enter,单一 Tab 停靠点,
aria-activedescendant。 - 受控或非受控 —
SelectedIds/ExpandedIds为null表示非受控,非null表示受控。 - 可选虚拟化 — 仅支持固定行高;
EnableVirtualization默认false。 - 健壮性 — 禁用节点、空状态、焦点恢复;
DataSource按稳定 ID 替换后状态保留。
快速开始
0.9.0 发布: 目标 .NET 10.0,只发布
net10.0资产。.NET 6 应用需停留在 0.8.0。GitHub Packages 由 release 工作流发布;nuget.org 需单独发布(见下文)。
包标识(0.8.0): NuGet 包 ID、程序集名称与静态资源基路径均为
Astrea.Components(旧名为Astrea)。请更新PackageReference Include="Astrea.Components",并把_content/Astrea/链接改为_content/Astrea.Components/;公共命名空间仍为Astrea.Components.*。0.8.0 是新包标识下的第一个版本,组件行为未变。
包只提供 net10.0 资产,宿主项目需要面向 .NET 10。以下命令在宿主 Blazor 项目目录中执行;0.9.0 已发布到 GitHub Packages,nuget.org 需单独发布(GitHub Packages 源配置见下文)。
- 安装 NuGet 包(本地开发也可直接引用
src/Astrea.Components/Astrea.Components.csproj):
dotnet add package Astrea.Components --version 0.9.0
- 在
_Imports.razor中添加命名空间:
@using Astrea.Components.Tree
- 在
wwwroot/index.html中引入样式表:
<link href="_content/Astrea.Components/astrea-tree.css" rel="stylesheet" />
- 最小示例:
<Tree DataSource="_roots" aria-label="Project files" />
@code {
private readonly List<TreeNode> _roots = new()
{
new TreeNode("Root", isExpanded: true)
};
}
GitHub Packages
发布版本也会推送到本仓库的 GitHub Packages 源。GitHub Packages 即使对公开包也要求认证,因此从该源还原需要具有 read:packages 权限的个人访问令牌。把源加入 nuget.config:
<configuration>
<packageSources>
<add key="astrea-github" value="https://nuget.pkg.github.com/HestiaLab/index.json" />
</packageSources>
<packageSourceCredentials>
<astrea-github>
<add key="Username" value="YOUR_GITHUB_USERNAME" />
<add key="ClearTextPassword" value="YOUR_GITHUB_TOKEN" />
</astrea-github>
</packageSourceCredentials>
</configuration>
Tree 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
DataSource |
IReadOnlyList<TreeNode>? |
必填 | 根节点 |
SelectionMode |
TreeSelectionMode |
Single |
Single 或 Multiple |
SelectedIds |
IReadOnlyCollection<string>? |
null |
null = 非受控;非 null 为受控选择的权威来源 |
SelectedIdsChanged |
EventCallback<IReadOnlyCollection<string>> |
— | 提议下一次受控选择;在应用提供新集合前不会提交 |
ExpandedIds |
IReadOnlyCollection<string>? |
null |
null = 非受控;非 null 为受控展开的权威来源 |
ExpandedIdsChanged |
EventCallback<IReadOnlyCollection<string>> |
— | 提议下一次受控展开;在应用提供新集合前不会提交 |
AllowDrag |
bool |
false |
启用拖放 |
EnableVirtualization |
bool |
false |
固定行高虚拟化 |
AutoDetectStructureChanges |
bool |
true |
每次渲染检测原地结构变化;大树可关闭,并在原地修改后调用 RefreshAsync |
ItemSize |
float |
32f |
行高(px);虚拟化时必须大于 0 |
UseInternalKeyboard |
bool |
true |
内置 ARIA 键盘导航 |
ShowLink |
bool |
true |
在缩进区域绘制父子连接线 |
BeforeExpandAsync |
Func<TreeNode, ValueTask<bool>>? |
null |
异步展开否决;用它替代 BeforeExpand |
BeforeCollapseAsync |
Func<TreeNode, ValueTask<bool>>? |
null |
异步折叠否决;用它替代 BeforeCollapse |
BeforeDropAsync |
Func<TreeDropEventArgs, ValueTask<bool>>? |
null |
异步拖放否决;用它替代 BeforeDrop |
BeforeRenameAsync |
Func<TreeNode, string, ValueTask<bool>>? |
null |
异步重命名否决;用它替代 BeforeRename |
BeforeEditNameAsync |
Func<TreeNode, ValueTask<bool>>? |
null |
异步进入编辑否决;用它替代 BeforeEditName |
Indent |
int |
20 |
每级缩进(px) |
OnlyHighlightText |
bool |
true |
选中时只高亮文本 |
LoadingText |
string |
"Loading items..." |
虚拟化加载占位文本 |
EditLabelFormat |
string |
"Edit {0}" |
默认编辑输入框的无障碍名称;{0} 为节点文本 |
RenameRejectedText |
string |
"Rename rejected" |
重命名被否决时的回退校验消息 |
NodeTemplate |
RenderFragment<TreeNode>? |
null |
自定义节点内容(与虚拟化不兼容) |
IconTemplate |
RenderFragment<TreeIconContext>? |
null |
自定义节点图标 |
EditTemplate |
RenderFragment<TreeEditContext>? |
null |
自定义编辑 UI(与虚拟化不兼容) |
BeforeExpand |
Func<TreeNode, bool>? |
null |
否决展开;false 阻止 |
BeforeCollapse |
Func<TreeNode, bool>? |
null |
否决折叠;false 阻止 |
BeforeDrop |
Func<TreeDropEventArgs, bool>? |
null |
否决拖放;false 阻止 |
BeforeRename |
Func<TreeNode, string, bool>? |
null |
否决重命名;false 阻止 |
BeforeEditName |
Func<TreeNode, bool>? |
null |
否决进入编辑模式;false 阻止 |
AdditionalAttributes |
IReadOnlyDictionary<string, object>? |
— | 合并到 role="tree" 容器上的额外 HTML 属性 |
受控状态契约
SelectedIds="null"与ExpandedIds="null"表示非受控模式。Tree 持有该状态,并报告真实的用户变更。- 非
null集合(包括空集合)表示受控模式。它始终是显示的权威来源。 - 在受控模式下,一次用户操作最多提议一个下一集合。在应用提供该集合之前,显示不会改变;即使未附加变更回调,或应用拒绝/延迟该提议,也是如此。
- 替换受控集合属于应用侧更新,不会再触发一次用户变更事件。
DataSource="null"与空数据源都会保留一个空但可访问的 Tree 容器。Tree 不会伪造节点。- 默认检测原地结构变化。大树可设置
AutoDetectStructureChanges="false",并在修改后调用RefreshAsync()。直接原地修改TreeNode.IsExpanded也需要RefreshAsync();优先使用ExpandedIds或SetExpandedAsync。 - 本次重构不引入隐藏的合成根模式。应直接把需要出现在第一可见层级的节点作为
DataSource根提供。
Tree 事件
| 事件 | EventArgs | 说明 |
|---|---|---|
OnSelectionChanged |
TreeSelectionChangedEventArgs |
选中实际变化时触发一次(OldSelectedIds、SelectedIds) |
OnExpandedChanged |
TreeExpandedChangedEventArgs |
展开状态变化时触发(Node、IsExpanded) |
OnNodeClicked |
TreeNodeEventArgs |
点击未禁用节点时触发 |
OnNodeInvoked |
TreeNodeEventArgs |
双击激活时触发 |
OnContextMenu |
TreeContextMenuEventArgs |
右键通知(Node、MouseArgs);Tree 不渲染菜单 |
OnDrop |
TreeDropEventArgs |
协议、结构与守卫检查全部通过后触发一次(SourceNodes、TargetNode、Relation) |
OnEditCommitted |
TreeEditEventArgs |
编辑提交时触发(Node、Value) |
OnEditCancelled |
TreeNodeEventArgs |
编辑取消时触发 |
OnEditRejected |
TreeEditRejectedEventArgs |
重命名被否决时触发(Node、Value、Reason) |
OnKeyDown |
KeyboardEventArgs |
内置键盘导航之前触发 |
公共方法
| 成员 | 说明 |
|---|---|
View |
只读 Tree 查询视图;Flatten/FlattenVisible 返回基于内部缓存的真实只读视图 |
SelectAsync、FocusAsync、BeginEditAsync、RefreshAsync |
以稳定节点 ID 标识、带校验的 Tree 命令 |
所有改变状态的公共路径都经过同一套所有权、禁用节点、选择模式、修订版本与会话校验。查询对象不暴露选择、展开、编辑或结构修改方法。
核心类型
TreeNode
var node = new TreeNode("Label", icon: null, bindData: null, id: "stable-id");
node.Add(new TreeNode("Child"));
- 标识:
Id(应用提供的 ID 可在重建后保留,否则自动分配)、Text(拒绝 null/空串)、BindData、PlaceHolder。 - 结构:
Parent、Children、Index、Level、IsRoot、HasChildren、IsLeaf、Root、Count、Siblings()、GetPathToRoot()、IsDescendantOf(node)、IsAncestorOf(node)。 - 结构变更:
Add、Remove、Insert、AddChildren、InsertChildren、RemoveChildren。成环挂载(挂到自身,或把祖先挂到其后代之下)会抛异常。 - 样式:
SetCssClass(string)、CssClassResolver(动态片段)、CssClass。 - 图标:
Icon、UnFoldIcon、ExpandedIcon、CollapsedIcon、ExpandIcon、FoldIcon、IsExpandIconDisable、IsFoldIconDisable、IsExpandDisable。 - 视图状态:
IsSelected与IsFocused是派生查询;IsEditing只有内部 setter。IsExpanded对应用只读:初始展开状态用构造函数参数isExpanded设置,之后使用ExpandedIds或SetExpandedAsync。IsDisabled仍是应用数据。 - 旧节点门面方法:只读查询辅助方法仍可用;改变状态的辅助方法收归到带校验的 Tree 命令边界内部。
Tree 查询视图(通过 Tree.View)
- 查询:选中的 ID、焦点 ID/节点、修订版本、稳定 ID 查找,以及扁平化的可见节点。
- 命令:选择、焦点、展开、编辑与刷新都通过 Tree 命令门面,而不是这个查询视图。
枚举与上下文
TreeSelectionMode:Single、Multiple。TreeDropRelation:Before、Inside、After。TreeEditContext(用于EditTemplate):Node、Value、SetValue(value)、CommitAsync()、CancelAsync()、ValidationMessage。TreeIconContext(用于IconTemplate):Node、IsExpanded、HasChildren、IsDisabled。
每个编辑上下文只属于一个编辑会话。一旦另一个编辑开始、其节点被替换或移除,或组件被释放,旧上下文的调用就不能提交或取消当前编辑。
API 迁移契约
| 旧接口 | 冻结方向 |
|---|---|
Tree.Controller、可写的 Controller.Selection,或可变的选中/展开集合 |
查询使用 Tree.View;TreeController 与 TreeState 成为内部实现细节 |
TreeController 上的状态变更方法 |
内部;使用以稳定节点 ID 标识、带校验的异步 Tree 命令 |
TreeNode 门面上的状态变更方法 |
内部;使用对应的带校验 Tree 命令 |
可写的 TreeNode.IsSelected、IsFocused 或 IsEditing |
不再作为权威状态;IsEditing 只有内部 setter |
作为第二状态源的 TreeNode.IsExpanded |
对应用只读;初始状态用构造函数参数 isExpanded,之后使用 ExpandedIds/SetExpandedAsync |
| 同步否决委托 | 在 Tree 上配置 Before* 或 Before*Async,不要同时配置;控制器级守卫已在 0.7.0 移除 |
| 元组形式的事件载荷 | 具名 EventArgs 类型 |
应用决策可以异步完成。Tree 在等待期间不提交,在应用结果前重新校验节点与操作;结果过期时保持状态不变,并且不会静默吞掉决策错误。一次拖放操作在接受、拒绝、取消、禁用或释放后最多被消费一次。
自 0.7.0 起,TreeController、TreeState、DragProtocol、TreeKeyboardNavigation 与 TreeDropValidation 均为内部类型。应用通过 Tree、TreeView、TreeNode、事件与上下文类型交互。
示例
多选
<Tree DataSource="_roots" SelectionMode="TreeSelectionMode.Multiple"
OnSelectionChanged="OnSelectionChanged" />
@code {
private void OnSelectionChanged(TreeSelectionChangedEventArgs args)
=> Console.WriteLine($"selection: {args.SelectedIds.Count} node(s)");
}
带否决的拖放
<Tree DataSource="_roots" AllowDrag="true"
BeforeDrop="BeforeDrop" OnDrop="OnDrop" />
@code {
private bool BeforeDrop(TreeDropEventArgs args)
=> args.TargetNode.Text != "Resources"; // forbid dropping into "Resources"
private void OnDrop(TreeDropEventArgs args)
{
// args.SourceNodes / args.TargetNode / args.Relation (Before | Inside | After)
// The app decides the final structure and updates its data source.
}
}
内联编辑
<Tree DataSource="_roots" BeforeRename="BeforeRename"
OnEditCommitted="OnEditCommitted" OnKeyDown="OnKeyDown" @ref="_tree" />
@code {
private Tree? _tree;
private bool BeforeRename(TreeNode node, string value) => !string.IsNullOrWhiteSpace(value);
private async Task OnKeyDown(KeyboardEventArgs args)
{
if (args.Key == "F2" && _tree?.View?.FocusedId is { } nodeId)
await _tree.BeginEditAsync(nodeId);
}
private void OnEditCommitted(TreeEditEventArgs args) => args.Node.Text = args.Value;
}
右键菜单通知
<Tree DataSource="_roots" OnContextMenu="OnContextMenu" />
@code {
private void OnContextMenu(TreeContextMenuEventArgs args)
{
// args.Node / args.MouseArgs — the tree only notifies; render your own menu.
}
}
固定行高虚拟化
<div style="height: 320px;">
<Tree DataSource="_largeDataSource" EnableVirtualization="true" ItemSize="32" />
</div>
虚拟化需要一个有界高度的滚动容器和固定行高。ItemSize 必须与节点高度一致,并且 NodeTemplate / EditTemplate 不能与虚拟化同时使用。
自定义图标与编辑模板
<Tree DataSource="_roots">
<IconTemplate Context="icon">
<span class="@(icon.IsExpanded ? "folder-open" : "folder")"></span>
</IconTemplate>
<EditTemplate Context="edit">
<input value="@edit.Value"
@oninput="e => edit.SetValue(e.Value?.ToString() ?? "")"
@onkeydown="e => OnEditKey(e, edit)" />
</EditTemplate>
</Tree>
@code {
private Task OnEditKey(KeyboardEventArgs e, TreeEditContext edit)
{
if (e.Key == "Enter")
{
return edit.CommitAsync();
}
if (e.Key == "Escape")
{
return edit.CancelAsync();
}
return Task.CompletedTask;
}
}
无障碍(WAI-ARIA)
Tree 遵循 WAI-ARIA Tree View 模式:容器上有单一 Tab 停靠点(role="tree" 与 tabindex="0"),role="treeitem" 节点不可聚焦,焦点通过 aria-activedescendant 跟踪。点击节点会把 DOM 焦点移到容器。组件输出 aria-level、aria-selected、aria-expanded 与 aria-disabled。禁用节点可导航,但不可选中、展开或激活。
ResourceTable
ResourceTable 渲染列驱动的表头与应用提供的表体。它支持指针与键盘调整列宽、工具栏操作、撤销/重做按钮,以及空列集合。
快速开始
@using Astrea.Components.ResourceTable
<link href="_content/Astrea.Components/astrea-resource-table.css" rel="stylesheet" />
<div style="height: 360px;">
<ResourceTable Columns="_columns"
TableBody="RenderRows"
ResizableColumns="true"
OnColumnResized="HandleColumnResized" />
</div>
@code {
private readonly List<TableColumn> _columns = new()
{
new("ID") { Key = "id", Width = "60px", MinWidth = 40 },
new("Name") { Key = "name", Width = "160px", MinWidth = 60 },
new("Type") { Key = "type" }
};
private RenderFragment RenderRows => builder =>
{
builder.OpenElement(0, "tr");
builder.OpenElement(1, "td");
builder.AddContent(2, "sample");
builder.CloseElement();
builder.CloseElement();
};
private void HandleColumnResized(ColumnResizedEventArgs args)
{
// args.ColumnIndex / args.ColumnKey / args.NewWidth
}
}
ResourceTable 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Columns |
IEnumerable<TableColumn> |
必填 | 列定义;空集合不渲染表头单元格 |
TableBody |
RenderFragment? |
必填 | 渲染在 tbody 内的表体标记 |
ToolBar |
RenderFragment? |
null |
额外工具栏内容 |
ShowButton |
bool |
true |
渲染新增/删除/移动按钮 |
ShowRedoButton |
bool |
false |
渲染撤销/重做按钮 |
ContainerCss |
string? |
null |
根容器的额外 CSS 类 |
ResizableColumns |
bool |
true |
渲染调整手柄并启用调整模块 |
CanUndo / CanRedo |
bool |
false |
撤销/重做按钮的禁用状态 |
OnAddClicked / OnRemoveClicked / OnMoveUpClicked / OnMoveDownClicked |
EventCallback |
— | 工具栏操作通知 |
OnUndoClicked / OnRedoClicked |
EventCallback |
— | 撤销/重做通知 |
OnKeyDown |
EventCallback<KeyboardEventArgs> |
— | 容器键盘事件转发 |
OnColumnResized |
EventCallback<ColumnResizedEventArgs> |
— | 指针或键盘调整列宽后触发 |
AddButtonLabel / RemoveButtonLabel / MoveUpButtonLabel / MoveDownButtonLabel / UndoButtonLabel / RedoButtonLabel |
string |
Add / Remove / Move Up / Move Down / Undo / Redo |
工具栏按钮的无障碍名称/提示 |
ResizeHandleLabelFormat |
string |
"Resize column {0}" |
调整手柄的无障碍名称;{0} 为列标题 |
IconAdd / IconRemove / IconMoveUp / IconMoveDown / IconUndo / IconRedo |
RenderFragment? |
null |
覆盖内置内联 SVG 图标 |
AdditionalAttributes |
IReadOnlyDictionary<string, object>? |
— | 额外 HTML 属性;应用的类会追加到组件类之后 |
TableColumn 声明 Title、Width、Key、MinWidth 与 Resizable(最后一列永远没有调整手柄)。
键盘与无障碍
- 每个调整手柄都是可聚焦的
role="separator",带aria-orientation="vertical"与无障碍名称。 - ArrowLeft/ArrowRight 以 10 px 调整焦点边界,遵守
MinWidth,并保持两列总宽度不变。 - 调整列宽的 keydown 事件不会停止传播;应用仍可通过
OnKeyDown收到它们。 ResizableColumns="false"会移除所有手柄并释放调整监听器。列定义或最小宽度变化时模块会重新初始化。
主题变量
组件公开有文档的 --ast-* 变量。可在组件根或任意祖先上覆盖。
Tree:
| 变量 | 默认值 | 用途 |
|---|---|---|
--ast-tree-font-size |
14px |
节点文本大小 |
--ast-tree-line-height |
1.6 |
节点行高 |
--ast-tree-color-text |
#1f2328 |
节点文本颜色 |
--ast-tree-node-height |
32px |
节点最小高度 |
--ast-tree-color-hover |
rgba(0,0,0,0.05) |
悬停背景 |
--ast-tree-color-focus |
rgba(24,144,255,0.15) |
焦点背景 |
--ast-tree-color-active |
rgba(24,144,255,0.25) |
选中背景 |
--ast-tree-color-border |
#d0d7de |
编辑输入框边框 |
--ast-tree-icon-size |
16px |
图标框大小 |
--ast-tree-control-indent |
20px |
展开控件槽宽度 |
--ast-tree-font-weight-bold |
600 |
粗体节点文本 |
ResourceTable:
| 变量 | 默认值 | 用途 |
|---|---|---|
--ast-rt-font-family |
sans-serif |
表格字体 |
--ast-rt-font-size |
14px |
表格字号 |
--ast-rt-color-text |
#333 |
文本颜色 |
--ast-rt-color-bg |
#fff |
表面/按钮背景 |
--ast-rt-color-header-bg |
#f5f5f5 |
表头背景 |
--ast-rt-color-border |
#ddd |
单元格/按钮边框 |
--ast-rt-color-border-strong |
#989ca4 |
滚动容器边框 |
--ast-rt-color-accent |
#268cda |
悬停/焦点强调色 |
--ast-rt-color-hover-bg |
#e0eef9 |
按钮悬停背景 |
--ast-rt-color-selected-bg |
#c3c3ff |
应用选中行背景 |
--ast-rt-color-resize |
#d0d7de |
调整指示线 |
--ast-rt-color-resizing-bg |
#f8f9fa |
调整列宽时的表头背景 |
--ast-rt-radius |
4px |
按钮圆角 |
--ast-rt-btn-size |
24px |
工具栏按钮尺寸 |
--ast-rt-icon-size |
14px |
工具栏图标尺寸 |
--ast-rt-resize-width |
24px |
调整手柄命中宽度 |
版本策略
Astrea 遵循语义化版本 2.0。版本低于 1.0.0 时,小版本可能包含已在文档中记录的破坏性行为变更;见 CHANGELOG.md。1.0.0 会冻结 SRS 中列为 Active 的组件的公共行为契约。包使用 global.json 固定的 .NET 10 LTS SDK 构建,并发布 net10.0 资产。
发布资产面向 net10.0。.NET 6 已停止支持;0.8.0 是最后一个发布 net6.0 资产的版本,.NET 6 应用需停留在 0.8.0 或升级到 .NET 10。
开发
见 CONTRIBUTING.md。需求可追溯到 docs/SRS.md(REQ-F-xxx / REQ-NF-xxx)。
任何改动后都必须通过以下验证命令:
dotnet build Astrea.sln
dotnet test Astrea.sln --no-build
dotnet format Astrea.sln --verify-no-changes --no-restore
python3 scripts/verify_srs_consistency.py
node --test tests/Astrea.JsTests/*.test.mjs
python3 scripts/verify_package.py
安装可选的无障碍工具并运行浏览器矩阵:
npm ci --prefix tests/Astrea.A11y
ASTREA_BROWSER_ENGINE=firefox dotnet test Astrea.sln --no-build --filter "TestCategory=Browser"
发布门禁使用 python3 scripts/verify_srs_consistency.py --release;只要任何 Active 需求在 docs/requirements-test-matrix.md 中仍有未闭环的证据缺口,它就会失败。实际浏览器、axe 与 Blazor Web App 结果记录在 docs/release-evidence.md。
当前发布门禁采用自动化验证范围:
- 浏览器:当前 Chromium/Firefox/WebKit 自动化矩阵,以及 Windows 上最新稳定版真实 Chrome 与 Edge。
- 可访问性:axe-core 对 Tree/ResourceTable 容器的 0 serious/critical 审计,以及自动化键盘/焦点测试。
- Safari、浏览器 N-1 与人工屏幕阅读器/WCAG 会话不在自动化发布门禁范围内;以下清单保留为可选人工 QA:
许可证
Astrea 以 MIT 许可证 发布。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.AspNetCore.Components (>= 10.0.14)
- Microsoft.AspNetCore.Components.Web (>= 10.0.14)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
See CHANGELOG.md.