kartik-v/yii2-widget-fileinput

Bootstrap 3.x的增强型 FileInput 小部件,具有文件预览,多个选择和更多功能

FileInput小部件是基于 Krajee 的 Bootstrap FileInput JQuery 插件的自定义文件输入小部件。该小部件使用各种功能增强了默认的HTML文件输入,包括:

  • 特别为Bootstrap 3.0设计风格,带有可自定义的按钮,标题和预览
  • 能够选择和预览多个文件
  • 包括文件浏览和可选的删除和上传按钮。
  • 能够格式化文件选择器按钮样式
  • 能够在上传之前预览文件 - 图像和/或文本(使用HTML5 FileReader API)
  • 能够预览不同类型的多个文件(包括图像和文本)
  • 设置上传操作/路由(默认为表单提交)。自定义上传和删除按钮。
  • 国际化使得能够轻松翻译成各种语言

注意:此扩展是yii2-widgets的子仓库拆分。自2014年11月8日以来已完成拆分,允许开发人员在需要时单独安装此特定小部件。也可以使用整个yii2-widget的前一种方式扩展。

安装

安装此扩展的首选方法是通过composer。检查composer.json以获取此扩展的要求和依赖关系。阅读此Web提示/ wiki,设置应用程序composer.json的最小稳定性设置。

要安装,请运行

$ 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]
]);