@frsource/light-scrollbar

中文文档
1.7.0发布于 2026/11/12MITTypeScriptESM + CJS构建来源已验证近 30 天下载 1.3万

创建自定义滚动条的最小化插件 ! @%%

中文使用文档
文档目录11 节
  1. 安装
  2. 现代JS/Typescript
  3. UMD 图像
  4. 铁路(可选)
  5. 样式
  6. 文档
  7. 演示实例
  8. 问 题
  9. 更改日志
  10. 贡献
  11. 许可证

NPM version badge Core bundle size badge. Data from bundlephobia.com changesets badge Tree shaking supported license MIT badge

光滑条 - 创建自定义滚动条的最小化灯光插件 ! @%

开始 • 妇女 文档 • 妇女 文件问题 • 妇女 有问题或想法吗?


轻而易举,可以创建自定义滚动条的小型库.
便于移动的桌面( T)
不重建滚动体验, 只是视觉代表浏览器滚动条
装有小捆绑大小( 少于 2500B!) 的表演者( A)
使用 " 滚动-行为:平滑 " 的可能性
由JS ES5或现代浏览器单独捆绑出版 微捆绑
完全写入 类型标记

原载 麻省理工学院 许可证

https://www.frsource.org/light-scrollbar 页面存档备份,存于互联网档案馆

安装

# npm
npm install @frsource/light-scrollbar

# Yarn
yarn add @frsource/light-scrollbar

# Pnpm
pnpm add @frsource/light-scrollbar

现代JS/Typescript

import { attach } from "@frsource/light-scrollbar";
const scrollingElement = document.querySelector("element-with-overflow-auto");
attach(scrollingElement);

UMD 图像

const scrollingElement = document.querySelector("element-with-overflow-auto");
window.lightScrollbar.attach(scrollingElement);

铁路(可选)

滚动条拇指下的背景音轨 。 这是一个单独的条目,所以它只有在您导入时才会被添加到捆绑中:

import { attach } from "@frsource/light-scrollbar";
import { rail } from "@frsource/light-scrollbar/rail";
import "@frsource/light-scrollbar/dist/rail.css";

// every `rail` value that is not set is taken from `bar`
attach(scrollingElement, { enableRail: true, plugins: [rail], rail: { y: { width: 10 } } });

装入 UMD dist/rail.umd.js 通过 window.lightScrollbarRail.rail。 。 。 .

样式

颜色和半径是包含在样式中的默认的 CSS 变量 - 在滚动栏元素上仅覆盖您想要修改的变量, 其任何父变量或 :root数字 :

.my-scrollbar {
  --light-scrollbar-bar-background: #8b5cf6;
  --light-scrollbar-bar-background-active: #6d28d9;
  --light-scrollbar-bar-radius: 2px;
}

栏杆在上 栏杆和拇指在上 --light-scrollbar-rail-background, (中文(简体) ), --light-scrollbar-rail-radius, (中文(简体) ), --light-scrollbar-rail-bar-background 财务报告和审定财务报表 --light-scrollbar-rail-bar-background-active。 。 。 .

文档

博士们,请访问 frsource.org/light-scrollbar 页面存档备份,存于互联网档案馆

演示实例

检查我们的例子看看它是如何工作的!

问 题

不要犹豫 讨论委员会来啊!

更改日志

每一版本的更改记录在 发布注释 财务报告和审定财务报表 变换GELOG 文件。 。 。 .

贡献

发展发生在文件,所以运行 pnpm docs:dev 它运行微波段和 vitepress docs. 测试可以在 Cypress 运行中完成 pnpm cy 运行微波段和cypress

许可证

麻省理工学院

版权(c) 2022年至今, Szymon Dziewoński, FRSFURCE

版本与发布记录

@frsource/light-scrollbar 共发布 316 个版本,首次发布于 2022/03/16;过去 12 个月发布了 28 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.0latest2026/11/123 天前
1.6.12026/11/096 天前
1.6.02026/11/096 天前
1.5.02026/11/069 天前
1.4.2552026/11/0313 天前
1.4.2542026/11/0313 天前

关于 @frsource/light-scrollbar 的常见问题

@frsource/light-scrollbar 是什么?

创建自定义滚动条的最小化插件 ! @%%

如何安装 @frsource/light-scrollbar?

在项目目录运行 npm install @frsource/light-scrollbar,或使用 pnpm add / yarn add / bun add。

@frsource/light-scrollbar 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@frsource/light-scrollbar 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@frsource/light-scrollbar 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@frsource/light-scrollbar 可以商用吗?

@frsource/light-scrollbar 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@frsource/light-scrollbar 的下载量有多少?

根据 npm 官方下载统计,@frsource/light-scrollbar 在 2026/10/16 – 2026/11/14 这 30 天内被下载 13,245 次,日均约 442 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@frsource/light-scrollbar 还在维护吗?

最新版本 1.7.0 发布于 2026/11/12(3 天前);至今共发布 316 个版本,其中过去 12 个月发布了 28 个;首次发布于 2022/03/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。