最后同步日期：2026-04-15 | Godot 官方原文 — Slider

Slider

节点继承关系

继承链：Node → CanvasItem → Control → Range → Slider

定义

Slider 是滑动条的抽象基类，你不应该直接使用它，而是使用 HSlider（水平滑动条）或 VSlider（垂直滑动条）。滑动条就是音量调节那种——拖一个小滑块来选择一个数值。

使用频率：★★★ 一般常用（通过子类使用，非常常见）

节点用途

• 作为水平/垂直滑动条的基类
• 拖动滑块选择数值

使用场景

• 不直接使用，请使用 HSlider 或 VSlider

常用节点搭配

• HSlider — 水平滑动条（最常用）
• VSlider — 垂直滑动条

生效必备素材/资源

无需特殊资源。

节点属性与信号

继承自 Range

属性	类型	默认值	继承自	说明
value	float	0.0	Range	当前值
min_value	float	0.0	Range	最小值
max_value	float	100.0	Range	最大值
step	float	1.0	Range	每次滑动的步进值
rounded	bool	false	Range	是否取整

信号

信号	触发时机	参数
value_changed	滑块值变化时	float 新值
drag_started	开始拖动时	无
drag_ended	结束拖动时	bool 是否改变值

常用方法

继承自 Range 的所有方法。

代码示例

C

// Slider 是抽象基类，请使用 HSlider 或 VSlider
// 示例参考 HSlider 或 VSlider 页面

GDScript

# Slider 是抽象基类，请使用 HSlider 或 VSlider
# 示例参考 HSlider 或 VSlider 页面