jquery-fileinput

1.3.1 • Public • Published

jQuery File Input

Simple jQuery plugin for styling HTML file inputs.

Installation

Install with npm:

npm i --save jquery-fileinput

Install with bower:

bower install fileinput

Usage

HTML:

<script src="path/to/jquery/jquery.min.js"></script>
<script src="path/to/fileinput/fileinput.min.js"></script>
<input type="file" name="file">

JavaScript:

$('input[type="file"]').fileinput();

Including all options:

$('input[type="file"]').fileinput({
    title: 'Browse...',
    multipleText: '{0} files', // for multiple selection. {0} will be replaced with number of seleted files
    showMultipleNames: false, // if true, show filenames comma separated instead text from multipleText
    buttonClass: 'btn btn-default',
    selectedClass: 'file-selected',
    clearButton: '<button type="button" class="fileinput-clear close">&times;</button>',
    complete: function() {
        // $(this) is input[type="file"]
    }
});

Almost all options can be redefined by data-attributes:

  • data-title
  • data-multiple-text
  • data-show-multiple-names
  • data-button-class
  • data-selected-class

Also button title and class can be set from title and class attributes:

<input type="file" title="Обзор..." class="btn btn-danger">

If you want to disable styling some inputs you can add attribute data-fileinput-disabled to them.

Styling

Included CSS-styles work great with Bootstrap 3.

Just append fileinput.css:

<link rel="stylesheet" href="path/to/bootstrap/css/bootstrap.min.css">
<link rel="stylesheet" href="path/to/fileinput/fileinput.css">

Generated HTML-code:

<span class="fileinput-wrapper">
    <span class="fileinput btn btn-default">
        <span>Browse...</span>
        <input type="file">
    </span>
</span>

When file selected:

<span class="fileinput-wrapper file-selected">
    <span class="fileinput btn btn-default">
        <span>Browse...</span>
        <input type="file">
    </span>
    <span class="fileinput-name">
        file.zip
        <button type="button" class="fileinput-clear close">&times;</button>
    </span>
</span>

Readme

Keywords

Package Sidebar

Install

npm i jquery-fileinput

Weekly Downloads

19

Version

1.3.1

License

MIT

Unpacked Size

11.4 kB

Total Files

7

Last publish

Collaborators

  • alexantr