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提供