说明
Items 复用 TreeNode 树模型;点击箭头展开/收起、点击行选中并回填 Value(Key)。SelectLeafOnly 限定只能选叶子,AllowClear 显示清除按钮,DefaultExpanded 设定初始展开;支持 ↑/↓ 移动、←/→ 收起展开、回车选中、Esc 关闭。
常见能力:
- 树形下拉
- 展开与选中分离
- 仅叶子可选
- 键盘导航
- 可清除
用法
<SelectTree Items="@nodes" @bind-Value="@key" Placeholder="请选择" AllowClear="true" OnSelected="@OnPick" />
API 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
AllowClear |
bool |
false |
是否显示清除按钮。 |
DefaultExpanded |
HashSet<string> |
HashSet`1 |
初始展开的节点 Key 集合。 |
Id |
string |
null |
|
Invalid |
bool |
false |
错误状态。 |
Items |
List<TreeNode> |
[] |
树节点数据,复用 TreeNode。 |
OnSelected |
EventCallback<TreeNode> |
— | 事件 选中整节点回调。 |
Placeholder |
string |
null |
占位提示。 |
SelectLeafOnly |
bool |
false |
仅允许选中叶子节点,点击父节点只展开不选中。 |
Size |
string |
null |
尺寸:lg / sm。 |
Value |
string |
null |
绑定值(选中节点的 Key)。 |
ValueChanged |
EventCallback<string> |
— | 事件 |
Visible |
bool |
true |
取得或设置组件是否可见,默认为false。 |
VisibleChanged |
EventCallback<bool> |
— | 事件 取得或设置组件可见性变化时的回调事件。 |
Class |
string |
null |
取得或设置组件的CSS类名,用于自定义样式。 |
Disabled |
bool |
false |
取得或设置组件是否禁用,默认为false。 |
Style |
string |
null |
取得或设置组件的内联样式,用于自定义样式。 |
所有组件均继承
BaseComponent,除上表参数外还支持Class、Style、Disabled、Visible。
扫码关注公众号
扫码加入 QQ 群