README

yii2-widget-fileinput

FileInput 小部件是基于 Krajee 的 Bootstrap FileInput JQuery 插件定制的文件输入小部件。该小部件增强了默认的 HTML 文件输入，包括以下功能

专门针对 Bootstrap 3.x、4.x 和 5.x 设计，具有可定制的按钮、标题和预览
能够选择和预览多个文件
包括文件浏览和可选的删除和上传按钮。
能够格式化文件选择按钮样式
能够在上传前预览文件 - 图片和/或文本（使用 HTML5 FileReader API）
能够在上传前预览不同类型的多个文件（图片和文本）
设置上传操作/路由（默认为表单提交）。自定义上传和删除按钮。
启用国际化，方便翻译成各种语言

注意：此扩展是自 2014 年 11 月 8 日起从 yii2-widgets 分离的子存储库。分离是为了允许开发人员在需要时单独安装此特定小部件。也可以以前的方式使用此扩展，与 yii2-widgets 整套一起使用。

安装

安装此扩展的首选方式是通过 composer。检查此扩展的 composer.json 文件以获取此扩展的需求和依赖项。阅读此 web tip /wiki 了解如何为您的应用程序的 composer.json 设置 minimum-stability 设置。

要安装，请运行

$ php composer.phar require kartik-v/yii2-widget-fileinput "@dev"

或添加

"kartik-v/yii2-widget-fileinput": "@dev"

到您的 composer.json 文件的 require 部分。

有关按版本变化的详细信息，请参阅 CHANGE LOG。

演示

您可以在文档和演示中找到有关此扩展使用方法的详细信息。

用法

use kartik\file\FileInput;

// Usage with ActiveForm and model
echo $form->field($model, 'avatar')->widget(FileInput::classname(), [
    'options' => ['accept' => 'image/*'],
]);

// With model & without ActiveForm
echo '<label class="control-label">Add Attachments</label>';
echo FileInput::widget([
    'model' => $model,
    'attribute' => 'attachment_1',
    'options' => ['multiple' => true]
]);