跳到主要内容

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 ​

名称类型默认值说明
heightstring | number"undefined"容器高度;number 按 px 处理,不设置则随内容/父级高度
alwaysbooleanfalse常驻显示滚动条(透传 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>