Scrollbar 滚动条

用于替代浏览器原生滚动条。

基础用法

使用 height 设置滚动区域高度;不传则按父容器高度自适应。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

横向滚动

当内容宽度超过滚动容器宽度时出现横向滚动条。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

最大高度

仅当内容高度超过 max-height 时出现纵向滚动条。

1

2

3

手动滚动

可调用 setScrollTopsetScrollLeft 方法程序化控制滚动位置。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

无限滚动

滚动到底部时触发 end-reached,可用于无限加载。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

滚动条 API

滚动条 属性

名称说明类型默认值
height滚动区域高度string / number
max-height最大高度string / number
native是否使用原生滚动条样式booleanfalse
wrap-style外层包裹样式string / object
wrap-class外层包裹 classstring
view-style视图区域样式string / object
view-class视图区域 classstring
noresize不监听容器尺寸变化;容器尺寸不变时建议开启以优化性能booleanfalse
tag视图根元素标签stringdiv
always是否始终显示滚动条booleanfalse
min-size滚动条滑块最小尺寸number20
id视图元素 idstring
role a11y视图 rolestring
aria-label a11y视图 aria-labelstring
aria-orientation a11y视图 aria-orientationenum
tabindex外层包裹容器 tabindexnumber / string
distance触发 end-reached 的距离阈值(像素)number0

滚动条 事件

事件名说明类型
scroll滚动时触发,参数含 scrollLeftscrollTopFunction
end-reached滚动到达边缘时触发Function

滚动条 插槽

名称说明
default默认内容

滚动条 方法

名称说明类型
handleScroll处理滚动事件Function
scrollTo滚动到指定坐标Function
setScrollTop设置纵向滚动距离Function
setScrollLeft设置横向滚动距离Function
update手动更新滚动条状态Function
wrapRef外层包裹 DOM 引用object