# @deltablot/dropzone 中文文档
规范地址：https://npmcn.com/package/%40deltablot/dropzone/
版本：7\.4\.4
npm 元数据更新时间：2026-07-31T09:56:40.595Z
中文译文更新时间：2026-11-11T21:52:00.054Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40deltablot/dropzone
原文对照：https://npmcn.com/package/%40deltablot/dropzone/?lang=original
项目主页：https://github.com/NicolasCARPi/dropzone
源码仓库：https://github.com/NicolasCARPi/dropzone
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1.1 MB，23 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2023-12-27T17:17:46.708Z
- 最新版本发布：2026-07-31T09:56:40.297Z
- 近 30 天下载量：46962（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 4 个）
## 中文简介
为您处理拖放文件 .
## 安装
```sh
npm install @deltablot/dropzone
```
也可以使用：`pnpm add @deltablot/dropzone`、`yarn add @deltablot/dropzone`、`bun add @deltablot/dropzone`
## README
[](https://badge.fury.io/js/@deltablot%2Fdropzone) [](https://github.com/NicolasCARPi/dropzone/actions/workflows/validating.yml) [](https://github.com/NicolasCARPi/dropzone/actions/workflows/codeql-analysis.yml)
# 叉头
这种叉子的存在是因为上游不再维持了. 其目标是使这个库保持良好的状态,主要有bugfixs并可能稍有改进.
## 新软件包名称是 `@deltablot/dropzone`
# 说明
Dropzone是一个JavaScript库,可以将任意HTML元素变成一个 Dropzone. 这意味着用户可以拖放文件到它上, Dropzone 将 显示文件预览并上传进度,并通过 XHR (英语).
它完全可以配置,可以按照您的需要进行样式化,并被信任 成千上万.
## 快速启动
安装 :
```bash
$ npm install --save @deltablot/dropzone
# or with yarn:
$ yarn add @deltablot/dropzone
# or with bun:
$ bun add @deltablot/dropzone
```
第一个论点是必须附着的内容,第二个论点是: [`options`](https://npmcn.com/package/%40deltablot/dropzone/src/options.js) 对象.
作为 **ES6模块** (建议):
```js
import { Dropzone } from "@deltablot/dropzone";
const dropzone = new Dropzone("#elementId", { url: "/file/post" });
```
或用作 **通用JS模块**数字 :
```js
const { Dropzone } = require("@deltablot/dropzone");
const dropzone = new Dropzone("#elementId", { url: "/file/post" });
```
[检查我们不同的实例执行 捆绑器](https://github.com/dropzone/dropzone-examples)
* * *
**支助科**
```css
@import "@deltablot/dropzone/src/dropzone";
```
## 不使用包管理器或捆绑器?
使用这样的独立文件 :
```html
```
* * *
- [\* 完整的文档](https://doc.dropzone.deltablot.app/)
- [⚙️ `src/options.js`](https://github.com/NicolasCARPi/dropzone/blob/master/src/options.js) 所有可用选项
* * *
## 社区
如果您需要支援,请打开一个 [问题](https://github.com/NicolasCARPi/dropzone/issues)。 。 。 .
如果您有特性请求或想要讨论什么,请使用 [问题](https://github.com/NicolasCARPi/dropzone/issues) 还有.
## 主要特点
- 默认美丽
- 图像缩略图预览 。 只需登记回电 `thumbnail(file, data)` 并显示您喜欢的图像
- 高DPI 屏幕支持
- 多个文件和同步上传
- 最新进展
- 支持大文件
- 截断上传( 以较小块上载大文件)
- 支持 Amazon S3 多段上传
- 完成主题。 Droppzone的外观和感觉只是默认的主题. 你个 可以通过覆盖默认事件听众来定义全部内容.
- 浏览器图像调整大小( 在上传到您的图像前调整图像大小) 服务器)
- 测试的很好
# MIT 许可证
见 [自由主义](https://npmcn.com/package/%40deltablot/dropzone/LICENSE) 文件
## 常见问题
### @deltablot/dropzone 是什么？
为您处理拖放文件 \.
### 如何安装 @deltablot/dropzone？
在项目目录运行 npm install @deltablot/dropzone，或使用 pnpm add / yarn add / bun add。
### @deltablot/dropzone 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @deltablot/dropzone 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @deltablot/dropzone 可以商用吗？
@deltablot/dropzone 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @deltablot/dropzone 的下载量有多少？
根据 npm 官方下载统计，@deltablot/dropzone 在 2026/10/12 – 2026/11/10 这 30 天内被下载 46,962 次，日均约 1,565 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @deltablot/dropzone 还在维护吗？
最新版本 7\.4\.4 发布于 2026/07/31（3 个月前）；至今共发布 19 个版本，其中过去 12 个月发布了 4 个；首次发布于 2023/12/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。