README

为Craft 3设计的低调前端资产上传器。可作为独立上传器或作为表单中的一个字段使用

特性

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

要求

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

安装

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

1. 通过Composer安装

   composer require fruitstudios/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插件商店可用时，此插件将变为付费插件。

由FRUIT提供