Tree

层级数据展示，支持展开、选中与禁用。

最后更新 2026-10-25 19:27:08

说明

TreeNode 递归包含 Children，选中项通过 SelectedKey 双向绑定。

常见能力：

<Tree Items="@nodes" @bind-SelectedKey="@key" />

参数	类型	默认值	说明
`Cascade`	`bool`	`true`	勾选联动模式：true=自助级联（默认）；false=只翻被点节点，联动交给调用方。
`Checkable`	`bool`	`false`	是否显示复选框、开启勾选。默认关。
`CheckedKeys`	`HashSet<string>`	HashSet`1	已完全勾选的节点 key 集合（半选节点不在其中）。
`CheckedKeysChanged`	`EventCallback<HashSet<string>>`	—	事件
`Expanded`	`HashSet<string>`	HashSet`1	展开的节点 key 集合。
`HalfCheckedKeys`	`HashSet<string>`	`null`	半选（indeterminate）节点 key 集合。仅当 Cascade 为 false 时按调用方给定值显示；为 true 时由 Tree 依子节点自动推导，无需外部提供。
`Items`	`List<TreeNode>`	`[]`
`OnNodeClick`	`EventCallback<string>`	—	事件
`SelectedKey`	`string`	`null`	当前选中 key。
`SelectedKeyChanged`	`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。