For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/components/scroll-area.md.

滚动区域

滚动区域限制长内容的可视范围,同时保留内容顺序和可发现的滚动行为。

实时预览

标签

v1.2.0-beta.50
v1.2.0-beta.49
v1.2.0-beta.48
v1.2.0-beta.47
v1.2.0-beta.46
v1.2.0-beta.45
v1.2.0-beta.44
v1.2.0-beta.43
v1.2.0-beta.42
v1.2.0-beta.41
v1.2.0-beta.40
v1.2.0-beta.39
v1.2.0-beta.38

用法

引入 CSS

导入 Tailwind 和一个完整的 A3S UI 样式包。

@import "tailwindcss";
@import "@a3s-lab/ui/a3s.css";

或者仅导入基本CSS和一个样式包。

@import "tailwindcss";
@import "@a3s-lab/ui/base.css";
@import "@a3s-lab/ui/styles/a3s.css";

区域滚动使用 A3S UI 滚动条工具类(.scrollbar / .scrollbar-sm)。

使用CDN或批量程序导入?请参见安装页。

添加滚动区域 HTML

在已使用 overflow-auto、overflow-y-auto 或 overflow-x-auto 滚动的元素上使用 scrollbar 或 scrollbar-sm。

<div class="scrollbar h-72 overflow-y-auto rounded-md border p-4">
  Your scrollable content here.
</div>

在已使用 overflow-auto、overflow-y-auto 或 overflow-x-auto 滚动的元素上使用 scrollbar 或 scrollbar-sm。

工具类增强了原生滚动的跨浏览器样式。它不封装内容、取代浏览器滚动行为或需要 JavaScript。需要键盘滚动的宿主应保持 overflow 元素可聚焦(tabindex="0" 或原生控件)。React/Vue 的 ScrollArea 导出在下一主版本迁移前仅作为兼容别名保留。

示例

这些示例使用卡片作为框架表面,因此源自半径活动样式包。

卧式

将 scrollbar 与 overflow-x-auto 结合使用以实现水平滚动。

实时预览
Photo by Ornella Binni
Photo by Tom Byrom
Photo by Vladimir Malyavko

薄型

将 scrollbar-sm 用于紧凑的可滚动区域,例如菜单、列表框、侧边栏和命令结果。

实时预览
Recent files

RTL

在可滚动元素或其祖先之一上设置 dir="rtl" 以使用从右到左布局。

实时预览

العلامات

v1.2.0-beta.50
v1.2.0-beta.49
v1.2.0-beta.48
v1.2.0-beta.47
v1.2.0-beta.46
v1.2.0-beta.45
v1.2.0-beta.44
v1.2.0-beta.43
v1.2.0-beta.42
v1.2.0-beta.41
v1.2.0-beta.40
v1.2.0-beta.39
v1.2.0-beta.38