scroll-view
Scrollable view area. A view group that allows the view hierarchy placed within it to be scrolled. When using vertical scrolling, you need to give the scroll view a fixed height.
Example
bxml
bxss
js
Bug & Tip
tip
: The priority of scroll-into-view is higher than that of scroll-top.tip
: Scrolling in the scroll-view will prevent the page from bouncing back, so scrolling in the scroll-view cannot trigger onpulldownrefresh.tip
: To use the pull-down refresh, please use the scroll of the page instead of the scroll-view, so that you can return to the top of the page by clicking the status bar at the top.
#
PropsName | Type | Description | Default |
---|---|---|---|
scroll-x | boolean | Allow lateral scrolling | false |
scroll-y | boolean | Allow vertical scrolling | false |
scroll-top | string | number | Set vertical scroll bar position | |
scroll-left | string | number | Set horizontal scroll bar position | |
scroll-into-view | string | The value should be the ID of a child element (ID cannot start with a number). Set which direction to scroll, then scroll to the element in which direction | |
upper-threshold | string | number | When it is far from the top / left, the scrolltupper event is triggered | 50 |
lower-threshold | string | number | When it is far from the bottom / right, the scrollcolor event is triggered | 50 |
enhanced | boolean | Enable the scroll view enhancement feature. After enabling, you can operate scroll view through ScrollViewContext | false |
fast-deceleration | boolean | Sliding deceleration rate control (effective after the enhanced attribute is turned on at the same time) | false |
show-scrollbar | boolean | Enabled when enhanced:true, control the scrollbar show/hide | false |
refresher-enabled | boolean | Enable pull-down refresh, support from jssdk >= 4.9.0 | false |
refresher-threshold | number | refresher threshold to trigger refresh (in px), support from jssdk >= 4.9.0 | 45 |
refresher-default-style | string | refresher default style, support from jssdk >= 4.9.0 options: black, white, none | "black" |
refresher-background | string | refresher background style, support from jssdk >= 4.9.0 | "#FFF" |
refresher-triggered | boolean | is refresher triggered, support from jssdk >= 4.9.0 | false |
#
EventsName | Description |
---|---|
bindscroll | bindscroll Triggered when scrolling,Arguments
|
bindscrolltoupper | bindscrolltoupper Scroll to the top/Triggered on the left |
bindscrolltolower | bindscrolltolower Scroll to the bottom/Triggered on the right |
bindrefresherpulling | bindrefresherpulling Triggered when pulling down |
bindrefresherrefresh | bindrefresherrefresh Triggered when refreshing |
bindrefresherrestore | bindrefresherrestore Triggered when pull-down refresher restoring |
bindrefresherabort | bindrefresherabort Triggered when refresh aborting |