文档手册

behavior: scrollbar

2024-07-18 16:20:13

behavior: scrollbar

实现独立的滚动条输入元素。

Elements

默认情况下应用了以下行为:

  • <widget|vscrollbar /> 以及 <widget|hscrollbar /> - 垂直和水平滚动条

Attributes

此行为知道:

  • for="selector" - 声明此滚动条绑定到其他可滚动元素作为其(外部)滚动条。

Methods

  • scrollbar.values(position:int, min:int, max:int, page:int, step:int)

    设置滚动条元素的值 - 位置、最小值、最大值、页面 - 反映滚动条滑块的大小,步长 - 箭头按钮单击的增量值。

Properties

  • scrollbar.position - 读/写,整数 - 当前滑块位置。

  • scrollbar.min - 只读,整数 - 最小值。

  • scrollbar.max - 只读,整数 - 最大值。

  • scrollbar.page - 只读,整数 - 页面值,也反映滚动条滑块的大小。

  • scrollbar.step - 只读,整数 - 页面值,定义箭头按钮点击的位置增量/减量。

Value

整数,反映滑块的位置,范围内的整数 [min ...最大]。

Events

除了标准事件集(鼠标、键盘、焦点)行为外,滚动条还会生成:

Primary events

这些是滚动条部分的点击,非冒泡事件:

  • "scroll-step-plus"

  • "scroll-step-minus"

  • "scroll-page-plus"

  • "scroll-page-minus"

  • "scroll-slider-press"

  • "scroll-slider-release"

Change event

  • "change" - 冒泡事件,在主要事件的响应中和值更改后生成。

事件被传递到元素,而不是冒泡到它的父元素。在脚本中使用 element.on("scroll-step-plus",function(evt) {}) 处理程序来处理滚动事件。