is="drop-files"
Customized built-in elements
The goal of this module is to add user interaction on a file input with multiple files as a progressive enhancement (the form still works if this JavaScript is disabled). Live demo
Usage
With npm
Install the package using npm or yarn
npm i @grafikart/drop-files-element
# or
yarn add @grafikart/drop-files-element
Then import it in your script
import '@grafikart/drop-files-element'
With unpkg.com
<script type="module" src="//unpkg.com/@grafikart/drop-files-element"></script>
Then use the custom element in your html using is="drop-files
.
<input
type="file"
multiple
name="files[]"
label="Drop files here or click to upload."
help="Upload files here and they won't be sent immediately"
is="drop-files"
/>
Safari
Unfortunately safari doesn't support Custom built-in elements and you have to polyfill this feature at the moment using @ungap polyfill
<script src="https://unpkg.com/@ungap/custom-elements-builtin"></script>
Customization
Attributes
Attribute | Type | Description |
---|---|---|
label |
string |
The label used as a bold text for the drop area |
help |
string |
Help text used as a secondary text for the drop area |
CSS Custom Properties
Property |
---|
--drop-border-color |
--drop-border-color-hover |
HTML Structure
This component doesn't use shadow dom so you can customize the style using CSS and overwrite the style already included inside this custom element.
Changelog
1.0.9
- Fixed the behaviour of a single file input
1.0.8
- Correctly handle input without the "multiple" attribute (issue #4)
1.0.7
- Fixed a rendering bug on Firefox (issue #2)
1.0.6
- Fixed a bug happening when no attributes were passed to the component
1.0.5
- Fix style when box-sizing is set to border-box
1.0.4
- Better error handling
- Improved style for the delete button