UXML 元素 TagField

TagField 是一个仅限编辑器控件，允许用户从标签列表中选择一个标签。它通常用于检视面板Unity 窗口，显示有关当前选定游戏对象、资源或项目设置的信息，允许您检查和编辑值。更多信息
参见词汇表窗口，以允许用户为游戏对象Unity 场景中的基本对象，可以表示角色、道具、场景、摄像机、路径点等。游戏对象的功能由附加在其上的组件定义。更多信息
参见词汇表选择标签。

注意：要将元素与检视面板中的其他字段对齐，只需将.unity-base-field__aligned USS 类应用于它。有关更多信息，请参阅BaseField。

创建 TagField 元素

您可以使用UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。更多信息
参见词汇表构建器、UXML 或 C# 创建 TagField。以下 C# 示例创建了一个带有默认标签的 TagField

using UnityEditor.UIElements;
...
var tagField = new TagField();
tagField.label = "Tag";
tagField.value = "Player";

示例

以下 UXML 示例创建了一个 TagField

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <uie:TagField label="UXML Field" name="the-uxml-field" />
</UXML>

以下 C# 示例说明了 TagField 的一些可自定义功能

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<TagField>("the-uxml-field");
uxmlField.value = "Player";

// Create a new field, disable it, and give it a style class.
var csharpField = new TagField("C# Field");
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<string>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

要在 Unity 中实时尝试此示例，请转到窗口 > UI 工具包 > 示例。

C# 基类和命名空间

C# 类：TagField
命名空间：UnityEditor.UIElements
基类：PopupField_1

继承的 UXML 属性

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

此元素还从VisualElement继承以下属性

USS 类

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

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

其他资源

• UXML 元素 MaskField