插页

折叠是 UI 的可折叠部分。当您单击折叠的标题时，折叠会隐藏或显示它包含的元素。

创建折叠

折叠具有以下元素：

• 标签：可用作折叠的名称的标签。
• 切换：单击切换以展开或折叠容器子元素。它的样式看起来像箭头，而不是默认复选框。当容器折叠时，箭头指向右侧。当容器展开时，箭头指向下方。
• 容器：容器包含视觉元素实例化或派生自 C# 的可视化树的节点VisualElement类。您可以设置外观样式、定义行为并将其作为 UI 的一部分显示在屏幕上。更多信息
  请参阅术语表切换折叠时要显示或隐藏的内容。

您可以将元素添加到折叠的容器中，显示或隐藏功能会自动工作。

以下UI文档在其容器中创建了一个包含两个按钮的折叠。当您切换折叠时，这两个按钮会显示或隐藏。

<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../UIElementsSchema/UIElements.xsd" editor-extension-mode="False">
    <ui:Foldout text="Foldout" name="MyFoldout" value="true">
        <ui:Button text="First item" />
        <ui:Button text="Second item" />
    </ui:Foldout>
</ui:UXML>

响应用户作

Foldout 及其 Toggle 子元素响应 Change 事件。切换隐藏或显示折叠容器。

你可以将 Foldout 绑定到布尔变量，或通过INotifyValueChanged<bool>接口。

例子

以下 C# 代码片段创建 Foldout 并检查折叠是否已展开：

// Create a new foldout, add two elements to it and add it to the container
var cSharpFoldout = new Foldout {text = "Elements"};
cSharpFoldout.Add(new Label("Indented Label"));
cSharpFoldout.Add(new Slider("Indented Slider", 0, 100));
container.Add(cSharpFoldout);

cSharpFoldout.RegisterValueChangedCallback(e =>
{
    // Check whether the foldout is expanded
    if (cSharpFoldout.value)
    {
        Debug.Log("Foldout is expanded");
    }
    else
    {
        Debug.Log("Foldout is collapsed");
    }
});

C# 基类和命名空间

C# 类：Foldout
命名空间：UnityEngine.UIElements
基类：BindableElement

成员 UXML 属性

此元素具有以下成员属性：

继承的UXML属性

此元素从其基类继承以下属性：

此元素还继承了以下属性VisualElement:

USS 级

下表列出了所有 C# 公共属性名称及其相关的 USS 选择器。

您还可以使用 Inspector 或 UI Toolkit Debugger 中的 Matching Selectors 部分来查看哪些 USS 选择器会影响VisualElement在其层次结构的各个层面。

其他资源

• 更改事件
• 切换 允许用户打开或关闭选项的复选框。更多信息
  请参阅术语表