UXML 元素 Slider

滑块允许用户从一系列值中选择浮点值。您可以使用滑块来调整值，例如声音的音量或灯光的亮度。要设置值，您可以沿着轨道拖动滑块，或点击轨道本身。滑块还可以包含一个文本输入字段允许用户输入文本字符串的字段 更多信息
参见 术语表，您可以在其中直接修改值。

注意：要将元素与 检查器一个 Unity 窗口，显示有关当前选定游戏对象、资源或项目设置的信息，允许您检查和编辑值。 更多信息
参见 术语表 窗口中的其他字段对齐，只需将 .unity-base-field__aligned USS 类应用于它即可。有关更多信息，请参阅 BaseField。

创建滑块

您可以使用 UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。 更多信息
参见 术语表 构建器、UXML 或 C# 创建滑块。以下 C# 示例创建了一个具有默认值、低值和高值的滑块，并设置了滑块的方向

var slider = new Slider();
slider.value = 0.5f;
slider.lowValue = 0;
slider.highValue = 100;
slider.direction = SliderDirection.Horizontal;

设置页面大小

滑块控件具有一个页面大小属性，该属性控制单击滑块拇指两侧的轨道时拇指移动的距离以及值变化的幅度。

如果页面大小值为 0，则单击轨道会将拇指移动到光标或指针位置，并相应地更新值。

如果页面大小值大于 0，则单击轨道会将拇指向光标或指针位置移动特定距离。滑块控件将页面大小视为总范围的百分比。

例如，如果总范围是 200，页面大小是 20，则页面大小金额是 200 的 20%，即 40。每次单击轨道时，拇指都会移动，并且值增加或减少 40。

示例

以下 UXML 示例创建了一个滑块

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <Slider
        label="UXML Slider"
        name="the-uxml-slider"
        low-value="0"
        high-value="100"
        page-size="1"
        value="42.2" />
</UXML>

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

/// <sample>
// Get a reference to the slider from UXML and assign it its value.
var uxmlSlider = container.Q<Slider>("the-uxml-slider");
uxmlSlider.value = 42.2f;

// Create a new slider, disable it, and give it a style class.
var csharpSlider = new Slider("C# Slider", 0, 100);
csharpSlider.SetEnabled(false);
csharpSlider.AddToClassList("some-styled-slider");
csharpSlider.value = uxmlSlider.value;
container.Add(csharpSlider);

// Mirror value of uxml slider into the C# field.
uxmlSlider.RegisterCallback<ChangeEvent<float>>((evt) =>
{
    csharpSlider.value = evt.newValue;
});
/// </sample>

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

C# 基类和命名空间

C# 类：Slider
命名空间：UnityEngine.UIElements
基类：BaseSlider_1

继承的 UXML 属性

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

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

USS 类

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

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

其他资源

• UXML 元素 SliderInt
• UXML 元素 MinMaxSlider