Tree
Tree 组件将数据组织为节点的层次结构。每个节点包含唯一的键和标签。节点连接形成父子关系。您可以展开或折叠节点以显示或隐藏它们的子节点。图标可以明确您正在查看的节点类型及其是否被选中。选择支持一次选择一个或多个节点。
节点模型和树结构
TreeNode 的作用
树中的每个数据项都被封装在一个 TreeNode 中。该对象包含键、文本标签，并链接到其父节点和子节点。根节点是特殊的：它存在于每棵树中，但不可见。它作为所有顶级节点的容器，从而更容易管理树结构。
由于节点保留对其父节点和子节点的引用，因此遍历树是直接的。无论您是想向上、向下移动，还是通过键找到特定节点，这些连接始终可用。
创建和管理节点
节点是通过简单的工厂方法创建的，可以提供键和文本，或仅提供文本（这也充当键）。这确保每个节点都是有效且唯一可识别的。
将节点添加到树中涉及在父节点上调用 add() 或 insert()。这些方法处理分配父引用并通知树更新其 UI。
示例：
TreeNode parent = Tree.node("Parent");
TreeNode child = Tree.node("Child");
parent.add(child);
tree.add(parent);
尝试将同一节点分配给多个父节点将导致抛出异常。此安全机制确保树保持适当的层次结构，防止节点有多个父节点，这会破坏结构的完整性并导致意外行为。
显示代码
- Java
修改节点
通过调用 setText(String text) 可以更新节点的标签。此方法更改树中显示的节点文本。
要移除特定的子节点，使用 remove(TreeNode child)。这将子节点从其父节点中分离并从树结构中移除。它还会清除父引用。
如果您想要清除节点的所有子节点，请调用 removeAll()。这会移除每个子节点，清除它们的父引用，并清空子节点列表。
每个节点可以使用 setUserData(Object key, Object data) 在服务器端存储额外信息。这让您可以将任意元数据或引用与节点关联，而不会将这些数据暴露给客户端或 UI。
在演示中，双击一个节点以打开其文本的编辑器。输入新文本并保存以更新节点在树中的标签。
显示代码
- Java
- CSS
图标
图标提供关于节点所代表内容及其状态的视觉提示。它们通过一目了然地区分节点类型和选择状态来改善可读性。Tree 组件支持全局设置默认图标，自定义每个节点的图标，以及切换图标的可见性。
全局图标
树允许您 为折叠组、展开组、叶子节点和选定叶子设置默认图标。
示例：
tree.setCollapsedIcon(TablerIcon.create("folder"));
tree.setExpandedIcon(TablerIcon.create("folder-opened"));
tree.setLeafIcon(TablerIcon.create("file"));
tree.setLeafSelectedIcon(TablerIcon.create("file-checked"));
每个节点的图标
您可以通过为单个节点分配图标来覆盖全局默认值。当某些节点代表不同的概念时，例如“项目”文件夹或特殊文件，这非常有用。
示例：
node.setIcon(TablerIcon.create("project"));
node.setSelectedIcon(TablerIcon.create("project-selected"));
图标可见性
有时，您可能希望隐藏组或叶子的图标以减少杂乱。该组件允许您全局切换这些类别的可见性，使您能够简化树的外观而不会丢失结构。
示例：
tree.setGroupIconsVisible(false);
tree.setLeafIconsVisible(false);
显示代码
- Java
节点展开和折叠
节点可以展开或折叠，以控制树中可见的部分。这允许集中关注相关部分并支持懒加载或动态数据更新的场景。
展开和折叠操作
树支持通过其键或直接引用来展开和折叠单个节点。您还可以一次展开或折叠节点的所有后代。
这些操作使您可以控制树的可见程度，并支持数据的懒加载或关注感兴趣的区域。
示例：
tree.expand(node);
tree.collapse(key);
// 折叠子树
tree.expandFrom(node);
tree.collapseFrom(node);
根节点锚定树，但保持隐藏。折叠根节点通常会隐藏所有内容，使树看起来是空的。为避免这种情况，折叠根节点实际上会折叠所有子节点，但在内部保持根节点展开，确保树仍然正确显示其内容。
懒加载节点
树通过响应展开事件支持节点子节点的懒加载。当用户展开一个节点时，您的应用可以动态加载或生成该节点的子节点。这通过按需加载树的可见部分提高了性能。
使用 onExpand 事件检测节点何时被展开。在处理程序内部，检查节点的子节点是否是占位符（例如，旋转器或空节点），并在加载后用实际数据替换它们。
显示代码
- Java
选择
选择控制哪些节点被用户选中。Tree 组件支持灵活的模式和 API 来选择、取消选择和查询节点。
选择模式
您可以选择树是允许一次选择一个节点，还是同时选择多个节点。从多个选择切换到单个选择会自动取消选择除第一个选定节点以外的所有节点。
示例：
tree.setSelectionMode(Tree.SelectionMode.SINGLE);
当树设置为多重选择模式时，用户可以同时选择多个节点。这种工作方式取决于设备：
- 桌面（鼠标和键盘）： 用户按住 Ctrl 键（或在 macOS 上按 Cmd 键），然后单击节点以将其添加或移除当前选择。这允许选择多个单独的节点而不取消选择其他节点。
- 移动和触摸设备： 由于没有可用的修饰键，用户只需轻触节点进行选择或取消选择。每次轻触都会切换该节点的选择状态，从而通过简单的轻触实现轻松的多重选择。
选择和取消选择
节点可以通过引用 、键、单独或批量选择或取消选择。您还可以在一次调用中选择或取消选择节点的所有子节点。
示例：
// 通过引用或键选择节点
tree.select(node);
tree.selectKey(key);
// 通过引用或键取消选择节点
tree.deselect(node);
tree.deselectAll();
// 选择或取消选择节点的子节点
tree.selectChildren(parentNode);
tree.deselectChildren(parentNode);
选择状态检索
您可以通过利用以下代码获取当前选择：
// 获取选定节点的引用
TreeNode selected = tree.getSelected();
List<TreeNode> selectedItems = tree.getSelectedItems();
// 获取选定节点的键
Object selectedKey = tree.getSelectedKey();
List<Object> selectedKeys = tree.getSelectedKeys();
显示代码
- Java