Update picker documentation

This commit is contained in:
“Naeel”
2026-09-05 12:58:47 +03:00
parent 5d44c836e7
commit 8df4d22cfb
2 changed files with 44 additions and 27 deletions
+21 -6
View File
@@ -1,13 +1,28 @@
# Upload module
Скопируйте каталог `upload/` в проект и подключите:
Скопируйте каталог `upload/` в проект и подключите picker:
- `create_upload_refs_blueprint(config)` к Flask-приложению;
- `initUploadTable(config)` из `frontend/table/init_upload_table.js`;
- `uploadViaVM(files, vmUploadUrl)` из `frontend/upload/upload_via_vm.js`.
- локальный `fflate` до загрузки picker-модуля.
В конфигурации задаются URL ВМ-буфера, допустимые расширения, лимиты и параметры
повторных попыток pull. Backend-модуль хранит файлы сессии в памяти; обработка
файлов остаётся ответственностью приложения, которое интегрирует этот модуль.
`config` должен содержать `allowedExt`, а также ссылки на DOM-элементы
`fileInputEl`, `folderInputEl`, `tableBodyEl` и `countEl`.
Публичный API таблицы:
- `pickFiles()` и `pickFolder()` — открыть системный выбор;
- `getFiles()` — получить leaf-файлы с `path`, `name`, `size` и `file`;
- `addFiles(files)` — добавить файлы программно;
- `remove(id)` и `clear()` — удалить узел или очистить дерево.
Picker поддерживает разрешённые документы, папки и вложенные ZIP, хранит
исходные browser `File` objects и выполняет дедупликацию по пути и размеру.
Загрузка на VM, backend sessions и upload API не используются.
## Legacy
Каталоги `backend/` и старые ссылки на `uploadViaVM`/VM-буфер относятся к
предыдущей архитектуре и сохранены как legacy-остатки. Для текущей picker-only
интеграции они не нужны.
Для ZIP перед ES-модулями загрузите локальный `fflate` из `site/static/vendor/`.