Scrollbar 滚动条
uni-appH5微信小程序App
uni-app 跨端滚动容器。基于 <scroll-view> 实现定高纵向滚动,滚动条样式由各端原生接管(小程序/App 不支持 WebKit 伪元素定制滚动条)。
何时使用
需要定高滚动的区域:侧栏菜单、下拉列表、日志列表等。
何时不使用
整页滚动(用页面级滚动或 onPageScroll)。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
Scrollbar 滚动条 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
height | string | number | "undefined" | 容器高度;number 按 px 处理,不设置则随内容/父级高度 |
always | boolean | false | 常驻显示滚动条(透传 scroll-view 的 show-scrollbar);默认滚动时才显示。注意:小程序端该属性支持有限,可能始终不显示滚动条 |
Slots
| 名称 | 说明 |
|---|---|
default | 可滚动的内容 |
示例
固定高度滚动
vue
<Scrollbar height="160">
<Text>第 1 条:组件库支持三端。</Text>
<Text style="margin-top:8px">第 2 条:tokens 单一数据源。</Text>
<Text style="margin-top:8px">第 3 条:AI 可读契约。</Text>
<Text style="margin-top:8px">第 4 条:五套内置主题。</Text>
<Text style="margin-top:8px">第 5 条:按需引入。</Text>
<Text style="margin-top:8px">第 6 条:SSR 兼容。</Text>
<Text style="margin-top:8px">第 7 条:国际化。</Text>
</Scrollbar>常驻滚动条
vue
<Scrollbar height="120" always>
<Text>常驻滚动条适合桌面端数据面板。</Text>
<Text style="margin-top:8px">滚动时轨道始终可见。</Text>
<Text style="margin-top:8px">第三行内容。</Text>
<Text style="margin-top:8px">第四行内容。</Text>
</Scrollbar>嵌套卡片内容
vue
<Scrollbar height="140" always>
<Card title="更新日志">
<Text variant="secondary">v1.2 新增 12 个组件。</Text>
<Text variant="secondary" style="margin-top:6px">v1.1 主题系统上线。</Text>
<Text variant="secondary" style="margin-top:6px">v1.0 首个稳定版。</Text>
</Card>
</Scrollbar>