UXML 元素 Foldout

Foldout 是 UI(用户界面) 允许用户与您的应用程序进行交互。Unity 目前支持三种 UI 系统。 更多信息
参见 词汇表 中的可折叠部分。当您点击 Foldout 的标题时，Foldout 会隐藏或显示它包含的元素。

创建 Foldout

Foldout 具有以下元素

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

您可以将元素添加到 Foldout 的容器中，显示或隐藏功能会自动生效。

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

<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 子元素会响应 更改事件。Toggle 会隐藏或显示 Foldout 容器。

您可以将 Foldout 绑定到布尔变量，或通过 INotifyValueChanged<bool> 接口访问其值。

示例

以下 C# 代码片段创建了一个 Foldout，并检查 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 选择器。

您还可以使用 检查器或 UI 工具包调试器中的匹配选择器部分 查看哪些 USS 选择器会影响 VisualElement 在其层次结构的每个级别上的组件。

其他资源

• 更改事件
• Toggle一个复选框，允许用户切换选项的开启或关闭状态。 更多信息
  参见 词汇表