# @fancyapps/fancybox 中文文档

规范地址：https://npmcn.com/package/%40fancyapps/fancybox/

版本：3\.5\.7
npm 元数据更新时间：2022-06-12T17:51:42.520Z
中文译文更新时间：2026-11-14T09:42:15.689Z
软件包许可：GPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40fancyapps/fancybox
原文对照：https://npmcn.com/package/%40fancyapps/fancybox/?lang=original
项目主页：https://fancyapps.com/fancybox/3/
源码仓库：https://github.com/fancyapps/fancybox

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

- 包体积（解压后）：526 kB，26 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：jquery \>=1\.9\.0
- 首次发布：2017-03-24T19:42:08.623Z
- 最新版本发布：2019-03-11T19:07:47.856Z
- 近 30 天下载量：151225（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 0 个）

## 中文简介

触摸已启用、反应迅速且完全自定义的 jQuery 灯盒脚本

## 安装

```sh
npm install @fancyapps/fancybox
```

也可以使用：`pnpm add @fancyapps/fancybox`、`yarn add @fancyapps/fancybox`、`bun add @fancyapps/fancybox`

## README

# 花样框

j 查询显示图像、 视频等的灯盒脚本. 触摸已启用,反应迅速,可完全定制.

见 [项目页面](http://fancyapps.com/fancybox/3/) 用于文件和演示.

跟随 @thefancyapps (英语) 用于更新.

## 快开始

1\. 添加最新的 j 查询和花式框文件

```html
<script src="//code.jquery.com/jquery-3.2.1.min.js"></script>

<link  href="/path/to/jquery.fancybox.min.css" rel="stylesheet">
<script src="/path/to/jquery.fancybox.min.js"></script>
```

2\. 创建链接

```html
<a data-fancybox="gallery" href="big_1.jpg">
    <img src="small_1.jpg">
</a>

<a data-fancybox="gallery" href="big_2.jpg">
    <img src="small_2.jpg">
</a>
```

3\. 请慢用!

## 许可证

falseBox 被许可使用 [GPLv3 常规](http://choosealicense.com/licenses/gpl-3.0) 所有开源应用程序的许可证. 所有商业应用(包括您计划销售的网站,主题和应用程序)都需要商业许可证.

[更多信息,请查看falseBox许可](http://fancyapps.com/fancybox/3/#license)。 。 。 .

## 错误和特性请求

如果你发现错误,请报告 [在吉苏布](https://github.com/fancyapps/fancybox/issues)。 。 。 .

错误报告准则 :

1.  使用 GitHub 问题搜索 —— 请检查该问题是否已报告 .
2.  请检查是否已经固定了问题——尝试使用寄存器中的最新主机或开发分支复制.
3.  孤立问题——创造减试案例和活生生的例子. 您可以使用 CodePen 来叉出文档中发现的任何演示文稿,将其作为模板.

优秀的虫子报告不应该让其他人 需要追逐你得到更多信息. 请尽量在报告中详细介绍.

欢迎特别的要求。 请寻找已有的并使用GitHub的"反应"功能进行投票.

请不要在个人支持请求中使用问题跟踪器 - 使用 Stack Overflow([花式盒3号](http://stackoverflow.com/questions/tagged/fancybox-3) 而不是标记).

## 常见问题

### @fancyapps/fancybox 是什么？

触摸已启用、反应迅速且完全自定义的 jQuery 灯盒脚本

### 如何安装 @fancyapps/fancybox？

在项目目录运行 npm install @fancyapps/fancybox，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：jquery（\>=1\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fancyapps/fancybox 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fancyapps\_\_fancybox 是否存在。

### @fancyapps/fancybox 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @fancyapps/fancybox 可以商用吗？

@fancyapps/fancybox 使用 GPL-3\.0 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @fancyapps/fancybox 的下载量有多少？

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

### @fancyapps/fancybox 还在维护吗？

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

