README

Craft 3 的不起眼前端资产上传器。可以作为独立上传器使用，也可以作为表单中的一个字段。

功能

• 拖放上传
• 重新排序和删除上传
• 资产预览
• 可定制
• 它是纯原味的（零依赖，使用经过实战考验的 JavaScript 编写）

要求

此插件需要 Craft CMS 3.0.0-RC1 或更高版本。

安装

要安装此插件，请按照以下步骤操作

1. 使用 Composer 安装

   composer require presseddigital/uploadit
   

2. 在控制面板中，转到设置 → 插件，然后点击 Uploadit 的“安装”按钮。

使用 Uploadit

选项

{{ craft.uploadit.uploader({
	id: 'myUid',
	name: 'myFieldName',
    assets: [],

    field: 'images',
    element: entry,

    volume: 'myvolume',
	folder: 'my/folder/path',

    preview: 'image',
    transform: 'square',

    limit: 5,
    allowReorder: true,
    allowRemove: true,
    customClass: 'custom--class',

}) }}

id 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

name 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

assets 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

field 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

element 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

volume 选项

要从一个列表拖动元素到另一个列表，两个列表必须具有相同的 group 值。您还可以定义列表是否可以放弃、保留副本（clone）或接收元素。

• name: String — 组名
• pull: true|false|'clone'|function — 从列表移动的能力。 clone — 复制项目，而不是移动。
• put: true|false|["foo", "bar"]|function — 是否可以从其他列表添加元素，或是一个可以从中获取元素的组名数组。
• revertClone: boolean — 在将复制的元素移动到另一个列表后，将其还原到初始位置。

示例独立使用

{{ craft.uploadit.uploader({
	id: 'myUid',
	name: 'myFieldName',
	assets: [],
	volume: 'myvolume',
	folder: 'my/folder/path',
	preview: 'image',
	transform: 'square',
    themeColour: '#ff00ff',
}) }}

示例表单使用

{{ craft.uploadit.uploader({
	id: 'myUid',
	name: 'myFieldName',
    assets: [],
    field: 'images',
    element: 345678,
    preview: 'image',
    transform: 'square',
    themeColour: '#ff00ff',
}) }}

路线图

• 更好的验证
• 翻译 JavaScript 字符串

注意：当 Craft 插件商店可用时，此插件将成为付费插件。

由 Pressed Digital 提供