bricks/docs/zh/scroll.md

VScrollPanel

控件功能：垂直滚动面板，用于在内容超出容器高度时提供垂直滚动能力，并支持在滚动接近顶部或底部时触发阈值事件。
类型：容器控件
父类控件：bricks.VBox

初始化参数

参数名	类型	说明
min_threshold	Number (可选)	滚动条到达顶部附近时触发 min_threshold 事件的阈值比例，默认为 0.02（即 2%）
max_threshold	Number (可选)	滚动条到达底部附近时触发 max_threshold 事件的阈值比例，默认为 0.95（即 95%）
width	String	默认设置为 '100%'，控件宽度占满父容器
height	String	默认设置为 '100%'，控件高度占满父容器
css	String (可选)	自定义 CSS 类名，会额外添加 'scrollpanel' 类
overflow	String	固定为 'auto'，启用滚动条自动显示

注意：以上 width、height、css、overflow 会在构造函数中自动设置。

主要事件

• min_threshold
  当垂直滚动位置接近顶部（根据 min_threshold 判断）时触发，通常表示用户已滚动到最上方，可用于加载更多内容等操作。

• max_threshold
  当垂直滚动位置接近底部（根据 max_threshold 判断）时触发，常用于实现“滚动到底自动加载”功能。

---

HScrollPanel

控件功能：水平滚动面板，用于在内容超出容器宽度时提供水平滚动能力，并可在滚动接近最左或最右时触发阈值事件。
类型：容器控件
父类控件：bricks.HBox

初始化参数

参数名	类型	说明
min_threshold	Number (可选)	水平滚动条到达最左侧附近时触发 min_threshold 事件的比例阈值，默认为 0.01（即 1%）
max_threshold	Number (可选)	水平滚动条到达最右侧附近时触发 max_threshold 事件的比例阈值，默认为 0.99（即 99%）
width	String	默认设置为 '100%'，控件宽度占满父容器
height	String	默认设置为 '100%'，控件高度占满父容器
css	String (可选)	自定义 CSS 类名，会合并 'scrollpanel' 类
overflow	String	固定为 'auto'，允许出现水平滚动条

注意：width、height、css、overflow 由构造函数自动配置。

主要事件

• min_threshold
  当水平滚动位置接近最左侧时触发，可用于加载左侧更多内容或执行其他逻辑。

• max_threshold
  当水平滚动位置接近最右侧时触发，适用于实现“横向滚动加载更多”场景。