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

最大高度

当元素高度超过最大高度,才会显示滚动条。

1

2

3

手动滚动

使用 setScrollTopsetScrollLeft 方法可以手动控制滚动条滚动。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

无限滚动 2.10.0

当滚动条到达底部时,会触发 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

属性

名称描述类型默认值
高度滚动条高度string / number
max-height滚动条最大高度string / number
原生是否使用原生滚动条样式booleanfalse
wrap-style包裹容器的自定义样式string / object
wrap-class包裹容器的自定义类名string
view-style视图的自定义样式string / object
view-class视图的自定义类名string
noresize不响应容器尺寸变化,如果容器尺寸不会发生变化,最好设置它可以优化性能booleanfalse
tag视图的元素标签stringdiv
总是总是显示滚动条booleanfalse
min-size滚动条的最小尺寸number20
id 2.4.0视图的 idstring
role 2.4.0 a11y视图的角色string
aria-label 2.4.0 a11y视图的 aria-labelstring
aria-orientation 2.4.0 a11y视图的 aria-orientation枚举
tabindex 2.8.3包裹容器的 tabindexnumber / string
distance 2.10.5触发 end-reached 事件的距离(像素)number0

事件

名称描述类型
scroll滚动时触发,返回滚动的距离Function
end-reached 2.10.0滚动到底部时触发Function

插槽

名称描述
default自定义默认内容

暴露

名称描述类型
handleScroll处理滚动事件Function
scrollTo滚动到一组特定坐标Function
setScrollTop设置滚动条到顶部的距离Function
setScrollLeft设置滚动条到左边的距离Function
update手动更新滚动条状态Function
wrapRef滚动条包裹元素的 refobject

来源

组件样式文档

贡献者