# bs-file-selector
> A lightweight, non-dependent browser file selector,一个轻量无依赖的浏览器文件选择器
Latest version **0.0.7** (published 2019-11-07) · MIT license · 0 weekly downloads
## Install
```sh
npm install bs-file-selector
pnpm add bs-file-selector
yarn add bs-file-selector
bun add bs-file-selector
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support; pre 1.0.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 0.0.7 |
| Published | 2019-11-07 |
| First published | 2019-11-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 12.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | heemooo |
| Maintainers | heemooo |
| Keywords | bs-file-selector |
## Links
- npm: https://www.npmjs.com/package/bs-file-selector
- Repository: https://github.com/Heemooo/bs-file-selector
- Homepage: https://github.com/Heemooo/bs-file-selector#readme
- Issues: https://github.com/Heemooo/bs-file-selector/issues
- npm.io page: https://npm.io/package/bs-file-selector
## Recent versions
- 0.0.7 (latest) — 2019-11-07
- 0.0.6 — 2019-11-07
- 0.0.5 — 2019-11-07
- 0.0.4 — 2019-11-01
- 0.0.3 — 2019-11-01
- 0.0.2 — 2019-11-01
- 0.0.1 — 2019-11-01
- 1.0.0 — 2019-11-01
## README
# bs-file-selector
A lightweight, non-dependent browser file selector,一个轻量无依赖的浏览器文件选择器
## 项目的由来
我们常常遇到一些接入第三方上传插件的场景，如WebUploader等，它们的功能通常都很完善，但是我们用不上所有功能，
且其UI的定制也不是太容易，更有甚者，如华为obs的接入，其仅提供了文件上传功能，其它的部分需要自己实现，基于此，
实现一个`轻量、无依赖、可自定义`的浏览器文件选择器。
## 项目的使用
### 简单demo
下载bs-file-selector，并在页面中引入,简易demo如下
```html
```
### 自定义UI
在`addElement`回调方法的实现中你可以绑定自己的ui实现，调用`resourceFile.bindUI(ui);`绑定文件和UI，简单实现如下：
```html
//TODO 为了方便，需要引入JQuery和Layui，也可以直接用原生实现ui
```
### 获取文件
调用`selector.getFiles()`可以获取文件列表
### API
#### FileSelector
- array getFiles() 获取文件列表
- ResourceFile delete(uuid) 删除文件，返回被删除文件对象
#### ResourceFile
- 基础属性如下：
```
file:文件对象
isUploaded:是否已上传
name:文件名
size:文件大小(byte)
sizeText:文件大小
suffix:文件后缀
type:文件类型
ui:文件绑定的ui对象
uuid:自动生成的36位uuid
```
- void bindUI(obj) 绑定UI对象
- boolean uploaded(isUploaded) 设置文件上传状态或获取文件上传状态
---
_Source: https://npm.io/package/bs-file-selector · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._