@craftsjs/perfect-scrollbar

中文文档
7.0.1发布于 2026/06/19MITTypeScriptES Module近 30 天下载 3879

角形的完美滚动条库

中文使用文档
文档目录3 节
  1. 开始
  2. 兼容性
  3. 如何使用

手工业 完美滚动栏

用于用 perfect-scrollbar 增强滚动条的用户指令 .

开始

要开始,让我们通过 npm 安装软件包:

选择对应您的 Angular 版本的版本 :

角质@ crapsjs/ 完美- 滚动栏
第 19 条7.x 电话
第 18 条6.x (单位:千美元)
15个5.x 电话
第13条4.x (中文(简体) )
第12条3.x 运算
第11个2.x 数据
npm i @craftsjs/perfect-scrollbar perfect-scrollbar --S

兼容性

目前版本: 7.0.1 (与Angular v19相容)

如何使用

在组件中使用独立的指令

import { Component } from '@angular/core';
import { PerfectScrollbarDirective } from '@craftsjs/perfect-scrollbar';

@Component({
    selector: 'app-example',
    standalone: true,
    imports: [PerfectScrollbarDirective],
    template: `
        <div perfectScrollbar class="menu-scroll-container">
            ...large content
        </div>
    `
})
export class ExampleComponent {}
    .menu-scroll-container{
        position: relative; //this property is important
    }
<div perfectScrollbar class="menu-scroll-container">
    ...large content
</div>

选项

export interface Options {
    handlers?: string[];
    maxScrollbarLength?: number;
    minScrollbarLength?: number;
    scrollingThreshold?: number;
    scrollXMarginOffset?: number;
    scrollYMarginOffset?: number;
    suppressScrollX?: boolean;
    suppressScrollY?: boolean;
    swipeEasing?: boolean;
    useBothWheelAxes?: boolean;
    wheelPropagation?: boolean;
    wheelSpeed?: number;
  }
<div perfectScrollbar [perfectScrollOptions]="{ wheelPropagation: true }" class="menu-scroll-container">
    ...large content
</div>

版本与发布记录

@craftsjs/perfect-scrollbar 共发布 10 个版本,首次发布于 2020/07/06;过去 12 个月发布了 2 个版本。

版本发布日期距今
7.0.1latest2026/06/194 个月前
7.0.02026/06/194 个月前
6.1.02025/08/301.2 年前
6.0.02025/08/211.2 年前
5.1.02023/01/213 年前
5.0.02023/01/173 年前

关于 @craftsjs/perfect-scrollbar 的常见问题

@craftsjs/perfect-scrollbar 是什么?

角形的完美滚动条库

如何安装 @craftsjs/perfect-scrollbar?

在项目目录运行 npm install @craftsjs/perfect-scrollbar,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/core(>=19.0.0 < 20.0.0)、rxjs(>= 7.4.0 < 8.0.0)、perfect-scrollbar(>=1.0.0 < 2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@craftsjs/perfect-scrollbar 支持 TypeScript 吗?

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

@craftsjs/perfect-scrollbar 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@craftsjs/perfect-scrollbar 可以商用吗?

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

@craftsjs/perfect-scrollbar 的下载量有多少?

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

@craftsjs/perfect-scrollbar 还在维护吗?

最新版本 7.0.1 发布于 2026/06/19(4 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 2 个;首次发布于 2020/07/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。