https://github.com/loadingio/ldfile
https://github.com/loadingio/ldfile
Last synced: 19 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/loadingio/ldfile
- Owner: loadingio
- License: mit
- Created: 2019-05-25T01:47:51.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-06-20T07:26:43.000Z (over 1 year ago)
- Last Synced: 2025-10-02T23:30:51.350Z (4 months ago)
- Language: JavaScript
- Size: 1.26 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ldfile
file loader helper in vanilla JS.
## Usage
install vis npm:
npm install --save ldfile
include required js file:
then:
var ldf = new ldfile(config);
ldf.on("load", function(ret) {
for(i=0;i. default binary.
* `ldcv`: ldcover for choosing encoding for text type. fallback to browser prompt if omitted.
## API
* `on`: add event listener. Possible events:
- `load`: fired when input value changed, along with a list of objects with following members:
- `file`: the file object provided by browser.
- `result`: file content parsed by ldfile.
## ldfile / Static Methods
* `fromURL(url, type, encoding)` - load file by URL. return promise resolving to {result, file} object.
- params:
- `type`: the same as the type in ldfile object configuration.
- `encoding`: default utf-8 and only applicable when type is text.
- returns a Promise resolving with an object with following fields:
- `result`: parsed content based on given `type`.
- `file`: corresponding file object
- this function can be used to load file from Data URLs.
* `fromFile(file, type, encoding)` - load File object
- same with `fromURL` except that the first param (file) is a File object.
* `download(opt)` - download file based on `opt`, which contains:
- `href`: url for the file to download. either `href` or `blob` should be given.
- `blob`: file to download. ignored if `href` is provided
- `mime`: file format. ( e.g., "application/pdf" )
- `name`: saved filename
## Compatibility
ldfile uses following HTML5 features, which may not be supported by all browsers:
* File Reader ( IE <= 9; read as binary needs polyfill for IE <= 11 )
* Promise ( IE <= 11, some mobile browsers )
Please use Polyfills to support legacy browsers if necessary.
## License
MIT