yumoqing/bricks
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

droppable docs: add max_size/multiple, file upload example with FormData+fetch

Browse Source
This commit is contained in:
yumoqing 2026-07-23 16:45:14 +08:00
parent 675dd09d05
commit a6a4a485a9
1 changed files with 25 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
docs/zh/droppable.md
View File

@ -11,6 +11,8 @@
|-------|------|------|
| `group` | string | 分组名称，只接收同 group 的拖拽源。默认 `"default"`。 |
| `accepts` | string[] | 接受的类型列表。对内部元素匹配 `data-type` 属性；对外部文件匹配 MIME 类型或扩展名。如 `["card", "image/*", ".pdf"]`。 |
| `max_size` | number | （可选）单个文件最大字节数，超出则忽略。 |
| `multiple` | boolean | （可选）是否允许多文件拖入，默认 `true`。 |
| `animation` | number | 拖拽动画时间（毫秒）。 |
## 外部文件拖入
@ -28,20 +30,38 @@
| `dropremove` | 有内部元素被拖出（不会发生，因 Droppable 不可拖出） |
| `filedrop` | 有外部文件拖入。`event.params.files` 为文件数组，每项含 `{name, size, type, file}` |
## 示例 — 接收文件
## 示例 — 文件拖入并上传
```json
{
"widgettype": "Droppable",
"options": {"group": "upload", "accepts": ["image/*", ".pdf"]},
"options": {"accepts": ["image/*", ".pdf", ".docx"], "max_size": 10485760},
"subwidgets": [
{"widgettype": "Text", "options": {"text": "拖入图片或PDF文件"}}
{"widgettype": "Text", "options": {"text": "拖入文件到这里上传", "css": "drop-zone-text"}}
],
"binds": [{"event": "filedrop", "actiontype": "script",
"script": "var fs=event.params.files;alert('收到 '+fs.length+' 个文件');"}]
"binds": [{"wid": "self", "event": "filedrop", "actiontype": "script",
"script": "(function(){\n var fs = event.params.files;\n if (!fs.length) return;\n var dz = this;\n fs.forEach(function(f) {\n var fd = new FormData();\n fd.append('file', f.file, f.name);\n fetch('{{entire_url('/api/upload.dspy')}}', {method:'POST', body:fd})\n .then(function(r) { return r.json(); })\n .then(function(d) {\n if (d.status) {\n var c = dz.querySelector('.drop-zone-text');\n if (c) c.textContent = f.name + ' 上传成功 ✓';\n }\n })\n .catch(function(e) {\n var c = dz.querySelector('.drop-zone-text');\n if (c) c.textContent = f.name + ' 上传失败: ' + e.message;\n });\n });\n}).call(this);"}]
}
```
**上传脚本关键部分拆解：**
```javascript
// 1. 从 event.params 获取文件
var files = event.params.files; // [{name, size, type, file}]
// 2. 构建 FormData
var fd = new FormData();
fd.append('file', files[0].file, files[0].name); // file 是原生 File 对象
// 3. 发送到后端
fetch('/api/upload.dspy', {method: 'POST', body: fd})
.then(r => r.json())
.then(d => { /* d.status 为 true 表示成功 */ });
```
> **注意：** `event.params.files[].file` 是浏览器原生 `File` 对象，可直接用于 `FormData.append()` 或 `FileReader.readAsDataURL()`。
## 示例 — 接收内部元素
```json