kartik-v/yii2-widget-fileinput

An enhanced FileInput widget for Bootstrap 3.x & 4.x with file preview, multiple selection, and more features (sub repo split from yii2-widgets)

yii2-widget-fileinput

---

, _(*1)

The FileInput widget is a customized file input widget based on Krajee's Bootstrap FileInput JQuery Plugin. The widget enhances the default HTML file input with various features including the following:, _(*2)

• Specially styled for Bootstrap 3.x, 4.x and 5.x with customizable buttons, caption, and preview
• Ability to select and preview multiple files
• Includes file browse and optional remove and upload buttons.
• Ability to format your file picker button styles
• Ability to preview files before upload - images and/or text (uses HTML5 FileReader API)
• Ability to preview multiple files of different types (both images and text)
• Set your upload action/route (defaults to form submit). Customize the Upload and Remove buttons.
• Internationalization enabled for easy translation to various languages

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets., _(*3)

Installation

The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json., _(*4)

To install, either run, _(*5)

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

or add, _(*6)

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

to the require section of your composer.json file., _(*7)

Refer the CHANGE LOG for details of release wise changes., _(*8)

Demo

You can refer detailed documentation and demos on usage of the extension., _(*9)

Usage

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

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute]. , _(*10)

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute], _(*11)

Individuals

, _(*12)

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute], _(*13)

, _(*14)

License

yii2-widget-fileinput is released under the BSD-3-Clause License. See the bundled LICENSE.md for details., _(*15)