Appearance
Scrollbar 滚动条
MoScrollbar 用于给指定滚动容器叠加自定义垂直滚动条。通过 target 绑定滚动容器,默认隐藏原生滚动条。
基础用法
Light
Dark
vue
<script setup lang="ts">
import { ref } from "vue";
const panelRef = ref<HTMLElement>();
</script>
<template>
<div ref="panelRef" class="panel">
...
</div>
<MoScrollbar :target="panelRef" />
</template>常显滚动条
Light
Dark
vue
<MoScrollbar :target="panelRef" always />尺寸和偏移
Light
Dark
vue
<MoScrollbar
:target="panelRef"
:size="10"
:offset="4"
:min-thumb-size="44"
always
/>保留原生滚动条
Light
Dark
vue
<MoScrollbar :target="panelRef" :hide-native="false" always />Scroll 事件
Light
scrollTop:0
Dark
scrollTop:0
vue
<MoScrollbar :target="panelRef" @scroll="handleScroll" />API
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
target | 绑定的滚动容器 ref 或元素 | HTMLElement | ComponentPublicInstance | - |
theme | 主题 | light | dark | light |
size | 滚动条宽度 | number | string | 6 |
minThumbSize | 滑块最小高度 | number | 28 |
offset | 距离容器右侧的偏移 | number | 0 |
always | 是否始终显示 | boolean | false |
hideNative | 是否隐藏原生滚动条 | boolean | true |
Events
| 事件 | 说明 | 回调参数 |
|---|---|---|
scroll | 目标容器滚动时触发 | event |