GitXplorerGitXplorer
J

bs-custom-file-input

public
208 stars
38 forks
42 issues

Commits

List of commits on branch master.
Verified
a4cb893188f06e94c811bac1e5c3682bb4b0e459

Update test.yml (#91)

XXhmikosR committed 4 years ago
Verified
7c6ae09cabfd0cd8bd0ce564ae1a495537bd6e90

Update test.yml (#90)

XXhmikosR committed 4 years ago
Verified
83f4ba44c3515d8f143261f42e8408d3239ff2de

chore(deps): bump ini from 1.3.5 to 1.3.7 (#88)

ddependabot[bot] committed 4 years ago
Verified
01454fdc70677957b54457e3e52e16c1114993b4

demo: update to Bootstrap v4.5.2 (#84)

XXhmikosR committed 4 years ago
Verified
64a5c9a947b30302c9531cc3caf74a3132469f37

chore(deps): bump lodash from 4.17.15 to 4.17.20 (#83)

ddependabot[bot] committed 4 years ago
Verified
df3034fc6a0b4e47a5c50ccb974ae1066cb59982

chore(deps): bump http-proxy from 1.18.0 to 1.18.1 (#82)

ddependabot[bot] committed 4 years ago

README

The README file for this repository.

bs-custom-file-input

npm version dependencies Status devDependencies Status Build Status Coverage Status JS gzip size BrowserStack Status

A little plugin which makes Bootstrap 4 custom file input dynamic with no dependencies.

You can use it on React and Angular too because this plugin is written with the most used JavaScript framework: VanillaJS.

Demo

Features:

  • Works with Bootstrap 4
  • Works without dependencies and jQuery
  • Display file name
  • Display file names for multiple input
  • Reset your custom file input to its initial state
  • Handle form reset
  • Allow custom selectors for input, and form
  • Allow to drag and drop files
  • Allow you to change the default display with a child in the <label> element
  • Built in UMD to be used everywhere
  • Small, only 2kb and less if you gzip it

Table of contents

Install

With npm

npm install bs-custom-file-input --save

CDN

CDN Link
jsDelivr https://cdn.jsdelivr.net/npm/bs-custom-file-input/dist/bs-custom-file-input.js
jsDelivr, minified https://cdn.jsdelivr.net/npm/bs-custom-file-input/dist/bs-custom-file-input.min.js

How to use it

You should wait for the document ready event and call the init method to make your custom file input dynamic. We expose one global variable available everywhere: bsCustomFileInput

$(document).ready(function () {
  bsCustomFileInput.init()
})

Use it with npm

import bsCustomFileInput from 'bs-custom-file-input'

For more examples check out this file.

This library is UMD ready so you can use it everywhere.

Methods

init

Finds your Bootstrap custom file input and will make them dynamic.

Parameters

  • inputSelector

    • default value: .custom-file input[type="file"]
    • type: string

    You can pass a custom input selector, but be sure to pass a file input selector

  • formSelector

    • default value: form
    • type: string

    Allows you to pass a custom form selector, but be sure to pass a form selector

destroy

Removes this plugin from your Bootstrap custom file input and restore them at their first initial state

Compatibility

bsCustomFileInput is compatible with:

  • IE10+
  • Edge
  • Firefox
  • Chrome
  • Safari
  • Chrome Android
  • Safari iOS

You can find our BrowserStack list of browsers here.

Support me

If you want to thank me, you can support me and become my Patron

Thanks

BrowserStack Logo

Thanks to BrowserStack for providing the infrastructure that allows us to test in real browsers!

License

MIT