Update picker documentation
This commit is contained in:
+21
-6
@@ -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/`.
|
||||
Reference in New Issue
Block a user