addFile('name值', '标题' [, '提示', '默认值', '限制大小', '文件后缀', '额外css类'])

版本 新增功能
1.0.5 自定义js回调函数

标识符:file

参数 含义 类型
name name值 string
title 标题 string
tips 提示 string
default 默认值 string
size 限制大小 string
ext 文件后缀 string
extra_class 额外css类 string

简单例子

return ZBuilder::make('form')
    ->addFile('file', '文件')
    ->fetch();

效果:

默认值

默认值是附件id,不要填写文件地址

限制大小

默认可以不同填写大小限制,可以在后台,“系统” -> “系统设置” -> “上传”设置。

如果在某些情况下,需要重新定义,可以填写此参数,大小为kb,比如限制上传大小为1mb。

return ZBuilder::make('form')
    ->addFile('file', '文件', '', '', '1024')
    ->fetch();

文件后缀

跟限制大小一样,可以在后台“系统” -> “系统设置” -> “上传”设置。

也可以重新定义

return ZBuilder::make('form')
    ->addFile('file', '文件', '', '', '1024', 'zip,7z')
    ->fetch();

自定义js回调

从1.0.5版本开始,可通过自定义js回调函数来处理上传成功之后,或者上传失败之后需要做的事情,比如:

return ZBuilder::make('form')
    ->addFile('file', '文件')
    ->js('test') // 引入自定义的外部js文件
    ->fetch();

然后在test.js中定义

var dp_file_upload_success = function () {
  console.log(1111)
};

那么在文件上传成功后,会执行dp_file_upload_success函数,在控制台输出1111.当然了,你也可以利用jQuery给表单添加个按钮,或者显示隐藏某些元素,这个按自己实际需求做就可以了。

dp_file_upload_success函数是针对表单中的所有文件上传组件,包括单文件上传,多文件上传,也就是说,不管你的表单中添加了多少个文件上传组件,每次上传成功,都会去执行dp_file_upload_success函数。

如果只想某个文件上传组件上传成功时才触发dp_file_upload_success函数,可以这么做。

return ZBuilder::make('form')
    ->addFile('file1', '文件1')
    ->addFile('file2', '文件2')
    ->js('test') // 引入自定义的外部js文件
    ->fetch();

test.js代码如下:

var dp_file_upload_success_file2 = function () {
  console.log(1111)
};

这样的话,只有当file2这个组件上传文件成功后才会触发dp_file_upload_success_file2函数。而当file1组件上传文件成功后,是不会触发dp_file_upload_success_file2函数的。

除了dp_file_upload_success函数外,还支持以下回调函数。
| 全局函数 | 含义 |
| --- | --- |
| dp_file_upload_success | 文件上传成功后执行,针对所有文件上传组件 |
| dp_file_upload_success_表单项名 | 仅对某个文件上传组件上传成功后起作用 |
| dp_file_upload_error | 文件上传失败后执行,针对所有文件上传组件 |
| dp_file_upload_error_表单项名 | 仅对某个文件上传组件上传失败后起作用 |
| dp_file_upload_complete | 文件上传完成后执行,针对所有文件上传组件 |
| dp_file_upload_complete_表单项名 | 仅对某个文件上传组件上传完成后起作用 |