SxTree (树形列表)
用于展示分层结构数据的树形列表。对齐 Microsoft Fluent UI Blazor TreeView (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。
使用场景
约束说明
- 通过
Items 提供树形数据。
Children 为空的节点不显示展开图标。
行为说明
- 点击节点触发
OnSelectedChange。
- 点击展开图标触发
OnExpandedChange 并切换状态。
API
Parameters (SxTree)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Items |
IEnumerable<SxTreeItemData>? |
null |
树形数据源。 |
| Implemented |
LazyLoadItems |
Func<SxTreeItemData, Task<IEnumerable<SxTreeItemData>>>? |
null |
延迟加载子节点。 |
| Implemented |
Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented |
Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
Parameters (SxTreeItem)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Item |
SxTreeItemData |
new() |
节点数据。 |
| Implemented |
OnExpandedChange |
EventCallback<SxTreeItemData> |
- |
展开状态改变事件。 |
| Implemented |
OnSelectedChange |
EventCallback<SxTreeItemData> |
- |
选中节点改变事件。 |
| Implemented |
Disabled (继承) |
bool |
false |
禁用状态。 |
| Implemented |
Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented |
Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
Events
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnExpandedChange |
EventCallback<SxTreeItemData> |
节点展开/折叠时触发。 |
| Implemented |
OnSelectedChange |
EventCallback<SxTreeItemData> |
选中节点变化时触发。 |
示例
<SxTree Items="_items" OnSelectedChange="HandleSelect" />
参考设计 (References)
