# @davestewart/nuxt-scrollbar 中文文档

规范地址：https://npmcn.com/package/%40davestewart/nuxt-scrollbar/

版本：1\.0\.0
npm 元数据更新时间：2023-04-11T00:22:17.902Z
中文译文更新时间：2026-11-12T02:51:36.673Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40davestewart/nuxt-scrollbar
原文对照：https://npmcn.com/package/%40davestewart/nuxt-scrollbar/?lang=original
项目主页：https://github.com/davestewart/nuxt-scrollbar#readme
源码仓库：https://github.com/davestewart/nuxt-scrollbar

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.3 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2023-04-07T17:42:32.988Z
- 最新版本发布：2023-04-11T00:22:17.781Z
- 近 30 天下载量：3167（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

Vue 3 的 Nuxt 包装器

## 安装

```sh
npm install @davestewart/nuxt-scrollbar
```

也可以使用：`pnpm add @davestewart/nuxt-scrollbar`、`yarn add @davestewart/nuxt-scrollbar`、`bun add @davestewart/nuxt-scrollbar`

## README

# Nuxt 滚动栏

> Vue 3 的 Nuxt 包装器

[![npm version](https://img.shields.io/npm/v/@davestewart/nuxt-scrollbar/latest.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@davestewart/nuxt-scrollbar) [![npm downloads](https://img.shields.io/npm/dm/@davestewart/nuxt-scrollbar.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@davestewart/nuxt-scrollbar) [![License](https://img.shields.io/npm/l/@davestewart/nuxt-scrollbar.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@davestewart/nuxt-scrollbar) [![Nuxt](https://img.shields.io/badge/Nuxt-18181B?logo=nuxt.js)](https://nuxt.com/)

## 概览

这是Nuxt 3包装 [Vue 3 完美滚动栏](https://www.npmjs.com/package/vue3-perfect-scrollbar) (转而包装) [完美滚动栏](https://www.npmjs.com/package/perfect-scrollbar)) (中文(简体) ).

它是一个相当简单的插件,但从设置服务器和客户端内容,附加事件处理器,以及导入样式中抽出麻烦.

### 关于包裹/ 替代包的注释

两者 [vue3- 完美- 滚动栏](https://github.com/mercs600/vue3-perfect-scrollbar/issues) 财务报告和审定财务报表 [完美滚动栏](https://github.com/mdbootstrap/perfect-scrollbar/issues) 似乎有点僵了 所以我觉得把图书馆包起来比较容易 [命名空格软件包](https://www.npmjs.com/package/@davestewart/nuxt-scrollbar) 宁可多待一天 几天公关.

注意还有 [nuxt- 完美- 滚动栏](https://www.npmjs.com/package/nuxt-perfect-scrollbar) 并且缺乏源代码.

## 演示

要查看 StackBlitz 上的演示:

-   [https://stackblitz.com/github/davestewart/nuxt-scrollbar?file=播放地%2Fapp.vue 页面存档备份,存于互联网档案馆](https://stackblitz.com/github/davestewart/nuxt-scrollbar?file=playground%2Fapp.vue)

要在当地运行演示 :

```
npm run dev
```

## 快速设置

安装 :

```bash
npm install --save @davestewart/nuxt-scrollbar
```

配置 :

```js
export default defineNuxtConfig({
  modules: [
    '@davestewart/nuxt-scrollbar'
  ],
})
```

## 使用量

### 标记

使用带有可选属性的滚动条的基本示例 :

```vue
<template>
  <NuxtScrollbar tag="aside" @ps-scroll-y="onScroll">
    <!-- your content -->
  </NuxtScrollbar>
</template>

<script setup>
function onScroll (event) {
  console.log(event)
}
</script>
```

说明:

-   您需要设置滚动条高度来滚动 !
-   自动导入滚动条样式

### 选项和活动

Vue 3 完美滚动栏选项 :

-   [https://github.com/mercs600/vue3-perfect-scrollbar#全球选择](https://github.com/mercs600/vue3-perfect-scrollbar#global-options)

完美的滚动栏选项和事件 :

-   [https://perfectscrollbar.com (中文(简体) )](https://perfectscrollbar.com/)

## 发展

为开发该模块:

```bash
# develop the module using the demo
npm run dev

# build and release (make sure to update version and changelog first)
npm run release
```

## 常见问题

### @davestewart/nuxt-scrollbar 是什么？

Vue 3 的 Nuxt 包装器

### 如何安装 @davestewart/nuxt-scrollbar？

在项目目录运行 npm install @davestewart/nuxt-scrollbar，或使用 pnpm add / yarn add / bun add。

### @davestewart/nuxt-scrollbar 支持 TypeScript 吗？

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

### @davestewart/nuxt-scrollbar 支持 ESM 还是 CommonJS？

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

### @davestewart/nuxt-scrollbar 可以商用吗？

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

### @davestewart/nuxt-scrollbar 的下载量有多少？

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

### @davestewart/nuxt-scrollbar 还在维护吗？

最新版本 1\.0\.0 发布于 2023/04/11（3 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/04/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。