iDesign

Scrollbar 滚动条

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

基础用法

通过 height 属性设置超出多少高度显示滚动条，若不设置则根据父容器高度自适应。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<template>
  <i-scrollbar :height="360">
    <div
      class="idesign-demo-itemy"
      v-for="n in 24"
      :key="n"
    >
      {{ n }}
    </div>
  </i-scrollbar>
</template>
显示代码

横向滚动

通过 width 属性设置超出多少宽度显示滚动条，若不设置则根据父容器宽度自适应。

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
<template>
  <i-scrollbar width="100%">
    <div class="idesign-demo-itemx-wrap">
      <div
        class="idesign-demo-itemx"
        v-for="n in 36"
        :key="n"
      >
        {{ n }}
      </div>
    </div>
  </i-scrollbar>
</template>
显示代码

滚动触发事件

可通过传入 onScrollX 和 onScrollY 分别控制水平和垂直滚动触发事件，参数均为该方向上的滚动比例。

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
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
<template>
  <i-scrollbar :height="360" @scrollY="handleScroll">
    <div
      className="idesign-demo-itemy"
      v-for="n in 36"
      :key="n"
    >
      {{ n }}
    </div>
  </i-scrollbar>
  <i-scrollbar width="100%" @scrollX="handleScroll">
    <div className="idesign-demo-itemx-wrap">
      <div
        className="idesign-demo-itemx"
        v-for="n in 36"
        :key="n"
      >
        {{ n }}
      </div>
    </div>
  </i-scrollbar>
</template>

<script setup>
const handleScroll = (val) => {
  console.log(val)
}
</script>
显示代码

Scrollbar Attributes

属性说明类型默认值
width滚动容器宽度string〡number--
height滚动容器高度string〡number--

Scrollbar Events

属性说明类型默认值
scrollX水平滚动触发事件(x: number) => void--
scrollY垂直滚动触发事件(y: number) => void--
Last Updated:
Contributors: Leophen