Scrollbar 滚动条
WebH5
自定义滚动条容器。内容原生滚动,细滑块样式统一各端表现,默认 hover 时才显示滚动条。
何时使用
需要统一、细化的滚动条样式:侧栏菜单、下拉列表、代码块等定高滚动区域。
何时不使用
整页滚动(页面级滚动条由全局样式处理)。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
height | string | number | "undefined" | 容器高度;number 按 px 处理,不设置则随内容/父级高度 |
always | boolean | false | 常驻显示滚动条;默认 hover 容器时才显示 |
Slots
| 名称 | 说明 |
|---|---|
default | 可滚动的内容 |
示例
定高滚动列表
示例加载中…
<Scrollbar height="180px">
<Stack :gap="8">
<Text v-for="i in 20" :key="i" tag="p">订单 2026080{{ i }} 已同步至仓库管理系统</Text>
</Stack>
</Scrollbar>常驻滚动条
示例加载中…
<Scrollbar :height="140" always>
<Stack :gap="8">
<Text v-for="i in 12" :key="i" tag="p" variant="secondary">第 {{ i }} 条操作日志:管理员更新了库存预警阈值</Text>
</Stack>
</Scrollbar>滚到底的可见标记
示例加载中…
<Scrollbar height="120px" always>
<Stack :gap="6">
<Text v-for="i in 8" :key="i" tag="p" variant="secondary" size="sm">第 {{ i }} 条记录</Text>
<Text tag="p" weight="medium" size="sm">—— 已经到底了 ——</Text>
</Stack>
</Scrollbar>Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Scrollbar 文档(含手机预览)。