formhelper是一个高级的、可自定义的文件输入/文件选择器插件,可以帮助开发人员轻松创建文件上传器。
1.在文档中加载所需的jQuery库和其他资源。
- <!-- Bootstrap Stylesheet (OPTIONAL) -->
- <link rel="stylesheet" href="/path/to/cdn/bootstrap.min.css" />
- <!-- jQuery is required -->
- <script src="/path/to/cdn/jquery.min.js"></script>
- <!-- Font Awesome Icons -->
- <link rel="stylesheet" href="/path/to/font-awesome/all.min.css" />
2.加载jQuery formhelper插件的文件。
- <link rel="stylesheet" href="./dist/css/jquery-formhelper.min.css" />
- <script src="./dist/js/jquery-formhelper.min.js" defer></script>
3.初始化HTML表单上的插件。
- <form class="uploader"></form>
- $(function(){
- var formhelper = $('.uploader').formhelper();
- });
4.在上传程序中添加一个文件选择器。
- var fileInput = formhelper.addFilePicker({
- // config the file input
- fileInput: {
- name: 'files[]',
- accept: [],
- multiple: false,
- },
- canRemove: true,
- canModify: true,
- canDragDrop: false,
- dragDropArea: false, // drop area
- container: false,
- maxBytes: 10 * 1024 * 1024,
- maxFiles: 10,
- // callbacks
- onChange: undefined,
- onCreate: undefined,
- onRemove: undefined,
- onDrop: undefined,
- onDragEnter: undefined,
- onDragOver: undefined,
- onDragLeave: undefined,
- offDragDrop: undefined,
- });
5.通过JavaScript将文件添加到上传器。
- fileInput.addFileBox({
- inputs: [
- {name: 'hideValue', value: 'demo'}
- ],
- files: [
- {
- name: '1.png',
- size: 11179,
- link: '1.png',
- },
- {
- name: '2.png',
- size: 356745,
- link: '2.png',
- },
- ],
- });
6.所有可能的选项表单助手
方法
- var formhelper = $('.uploader').formhelper({
- maxBytes: 20 * 1024 * 1024,
- maxFiles: 20,
- filePicker: {
- canRemove: true,
- canModify: true,
- canDragDrop: false,
- showFileSize: true,
- dragDropArea: false,
- container: false,
- maxBytes: 10 * 1024 * 1024,
- maxFiles: 10,
- onChange: undefined,
- onCreate: undefined,
- onRemove: undefined,
- onDrop: undefined,
- onDragEnter: undefined,
- onDragOver: undefined,
- onDragLeave: undefined,
- offDragDrop: undefined,
- fileInput: {
- name: 'files[]',
- accept: [],
- multiple: false,
- },
- },
- language: {
- selectFile: 'Select file',
- selectingFile: 'Selecting files...',
- unselectFile: 'No files selected.',
- limitMsg: 'File size limit ({0}). Upload limit {1} files.',
- acceptMsg: 'File accept format list: {0}',
- fileSizeOverload: 'File size overload! limit size: {1}',
- fileCountOverload: 'File count overload! limit count: {1}',
- },
- templates: {
- filePicker: false,
- fileBox: false,
- },
- onFail: function (e) {
- alert(`[${e.code}] ${e.msg}`);
- },
- });
7.获取有关文件选择器的信息。
- var total = formhelper.getFilePickerInfo();
- total.count
- total.sizeHum
- // get the number of files from the fileInput instance
- fileInput.getCount();
- // get the size of files from the fileInput instance
- fileInput.getSize(true)
v1.8.3 (2022-06-06)
v1.8.2 (2021-06-11)
v1.8.1 (2021-06-09)
v1.8.0 (2021-05-18)
2021-04-25