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

ScrollBar

节点继承关系

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

定义

ScrollBar 是滚动条的抽象基类，你不应该直接使用它，而是使用 HScrollBar（水平滚动条）或 VScrollBar（垂直滚动条）。就像网页右侧的那个可以拖动的长条——你拖它来查看超出屏幕的内容。通常 ScrollContainer 会自动管理滚动条，不需要手动创建。

使用频率：★★★ 一般常用（通常由 ScrollContainer 自动管理，很少手动使用）

节点用途

• 作为水平/垂直滚动条的基类
• 自定义滚动条外观时使用

使用场景

• 不直接使用，请使用 HScrollBar 或 VScrollBar
• 自定义 ScrollContainer 的滚动条样式时

常用节点搭配

• HScrollBar — 水平滚动条
• VScrollBar — 垂直滚动条
• ScrollContainer — 自动管理滚动条

生效必备素材/资源

无需特殊资源。

节点属性与信号

自有属性

属性	类型	默认值	继承自	说明
custom_step	float	0.0	—	自定义步进值

继承自 Range

属性	类型	默认值	继承自	说明
min_value	float	0.0	Range	最小值
max_value	float	100.0	Range	最大值
value	float	0.0	Range	当前值
step	float	1.0	Range	步进值

信号

信号	触发时机	参数
value_changed	值变化时	float 新值
scrolling	正在滚动时	无

常用方法

继承自 Range 的所有方法。

代码示例

C

// ScrollBar 是抽象基类，请使用 HScrollBar 或 VScrollBar
// 通常不需要手动创建，ScrollContainer 会自动管理

GDScript

# ScrollBar 是抽象基类，请使用 HScrollBar 或 VScrollBar
# 通常不需要手动创建，ScrollContainer 会自动管理