badbreze / yii2-widget-fileinput
此包已被弃用且不再维护。作者建议使用 kartik-v/yii2-widget-fileinput 包。
为 Bootstrap 3.x 提供增强的 FileInput 小部件,具有文件预览、多选等功能(从 yii2-widgets 分离的子仓库)
2.0.8
2017-02-07 15:54 UTC
Requires
- badbreze/bootstrap-fileinput: v4.3.6
- kartik-v/yii2-krajee-base: ~1.7
README
FileInput 小部件是基于 Krajee 的 Bootstrap FileInput JQuery 插件 定制的文件输入小部件。该小部件增强了默认的 HTML 文件输入,包括以下功能
- 特别为 Bootstrap 3.0 设计,带有可定制的按钮、标题和预览
- 能够选择和预览多个文件
- 包括文件浏览和可选的删除和上传按钮。
- 能够格式化文件选择按钮的样式
- 能够在上传前预览文件 - 图像和/或文本(使用 HTML5 FileReader API)
- 能够预览不同类型的多个文件(图像和文本)
- 设置上传操作/路由(默认为表单提交)。自定义上传和删除按钮。
- 支持国际化,方便翻译成多种语言
注意:此扩展是自 2014 年 11 月 8 日起从 yii2-widgets 分离的子仓库。分离是为了允许开发者在需要时单独安装此特定小部件。也可以像以前一样使用整个 yii2-widgets 套件中的扩展。
安装
安装此扩展的首选方式是通过 composer。检查此扩展的 composer.json 文件以获取此扩展的要求和依赖项。阅读此 web 提示 /wiki 了解如何为您的应用程序的 composer.json 设置 minimum-stability 设置。
要安装,请运行以下命令之一
$ php composer.phar require kartik-v/yii2-widget-fileinput "@dev"
或
"kartik-v/yii2-widget-fileinput": "@dev"
将以下内容添加到您的 composer.json 文件的 require 部分中。
最新版本
注意:模块的最新版本是 v1.0.4。有关详细信息,请参阅 变更日志。
演示
您可以参考有关扩展使用的详细 文档和演示。
用法
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] ]);
许可
yii2-widget-fileinput 在 BSD 3-Clause 许可下发布。有关详细信息,请参阅打包的 LICENSE.md 文件。