色域

ColorField 是一个仅限编辑器的控件，允许用户从颜色选取器中选择颜色。它支持 alpha 通道和 HDR 颜色。Alpha 通道是表示颜色透明度级别的额外通道。HDR高动态范围
请参阅术语表颜色是高动态范围的颜色，可以表示比标准颜色更广泛的颜色范围。

注意：要将元素与检查器一个 Unity 窗口，显示有关当前选定游戏对象、资产或项目设置的信息，允许您检查和编辑值。更多信息
请参阅术语表窗口，只需将.unity-base-field__alignedUSS 级。有关更多信息，请参阅BaseField.

创建 ColorField

你可以使用 UI Builder、UXML 或 C# 创建 ColorField。以下 C# 示例使用默认颜色创建 ColorField，并启用 alpha 通道、吸管，并将颜色视为 HDR 值。

using UnityEditor.UIElements;
...
var colorField = new ColorField();
colorField.value = new Color(0.5f, 0.5f, 0.5f, 1.0f);
colorField.showAlpha = true;
colorField.showEyeDropper = true;
colorField.hdr = true;

例

以下UXML示例创建了一个ColorField：

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

以下 C# 示例演示了 ColorField 的一些可自定义功能：

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

// Create a new field, disable it, and give it a style class.
var csharpField = new ColorField("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<Color>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

若要在 Unity 中实时试用此示例，请转到 Window > UI 工具包>示例。

C# 基类和命名空间

C# 类：ColorField
命名空间：UnityEditor.UIElements
基类：BaseField_1

成员 UXML 属性

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

继承的UXML属性

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

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

USS 级

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

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

其他资源

• HDR 颜色选择器参考
• 高动态范围