文件事件
可用于文件管理和文件操作的事件。
更改
只要通过文件浏览按钮在文件输入中选择单个文件或多个文件,就会触发此事件。
例:
$ ('#input-id' )。on ('change' ,function (event ){
控制台。记录(“改变” );
});
fileselect
通过文件浏览按钮在文件输入中选择文件后触发此事件。这与change事件略有不同,即使取消了文件浏览对话框,也会触发此事件。
例:
$ ('#input-id' )。on ('fileselect' ,function (event ,numFiles ,label ){
控制台。log (“fileselect” );
});
fileselectnone
当用户没有为重复选择方案选择文件时(即在已包含先前选择的文件的文件输入上),将触发此事件。此事件更适用于Google Chrome等浏览器,可在取消文件选择对话框时清除文件输入。对于其他浏览器,此事件通常仅在重置表单或清除文件输入(使用“删除”按钮)时触发。
例:
$ ('#input-id' )。on ('fileselectnone' ,function (event ){
控制台。log (“嗯!没有选择文件。” );
});
filebatchselected
在选择一批文件并在预览中显示后触发此事件。其他可用参数包括:
files:文件堆栈数组(如果不可用,则为空对象)。
例:
$ ('#input-id' )。on ('filebatchselected' ,function (event ,files ){
控制台。log ('文件批量选择触发' );
});
fileclear
当按下文件输入删除按钮或预览窗口关闭图标以清除文件预览时,将触发此事件。
例:
$ ('#input-id' )。on ('fileclear' ,function (event ){
控制台。log (“fileclear” );
});
filecleared
清除预览中的文件后会触发此事件。
例:
$ ('#input-id' )。on ('filecleared' ,function (event ){
控制台。log (“filecleared” );
});
fileloaded
在预览中加载文件后触发此事件。其他可用参数包括:
file:文件对象实例
previewId:预览文件容器的标识符
index:预览列表中已加载文件的从零开始的顺序索引
reader:FileReader实例(如果可用)。
例:
$ ('#input-id' )。on ('fileloaded' ,function (event ,file ,previewId ,index ,reader ){
控制台。log (“fileloaded” );
});
filereset
当文件输入重置为初始值时,将触发此事件。
例:
$ ('#input-id' )。on ('filereset' ,function (event ){
控制台。log (“filereset” );
});
fileimageloaded
在预览窗口中完全加载每个文件图像时会触发此事件。这仅适用于图像文件预览和ifshowPreview设置为true。其他可用参数包括:
previewId:预览文件容器的标识符。
例:
$ ('#input-id' )。on ('fileimageloaded' ,function (event ,previewId ){
控制台。log (“fileimageloaded” );
});
fileimagesloaded
在预览窗口中完全加载所有文件图像时会触发此事件。这仅适用于图像文件预览和ifshowPreview 设置为true。
例:
$ ('#input-id' )。on ('fileimagesloaded' ,function (event ){
控制台。log (“fileimagesloaded” );
});
fileimageresized
当预览窗口中的文件图像基于其调整大小时,将触发此事件 resizeImage 和 maxImageWidth 要么 maxImageHeight设置。这仅适用于图像文件预览和ifshowPreview设置为true。其他可用参数包括:
previewId:预览文件容器的标识符。
index:预览列表中已加载文件的从零开始的顺序索引
当预览中的所有图像都已调整大小时,上述事件将再次触发而没有任何上述参数(即`previewId`和`index`为`undefined`)。
例:
$ ('#input-id' )。on ('fileimageresized' ,function (event ,previewId ,index ){
控制台。log (“fileimageresized” );
});
fileimagesresized
当预览窗口中的所有文件图像都根据时间调整大小时,将触发此事件 resizeImage 和 maxImageWidth 要么 maxImageHeight设置。这仅适用于图像文件预览和ifshowPreview 设置为true。
例:
$ ('#input-id' )。on ('fileimagesresized' ,function (event ){
控制台。log (“fileimagesresized” );
});
filebrowse
单击文件浏览按钮以打开文件选择对话框时会触发此事件。
例:
$ ('#input-id' )。on ('filebrowse' ,function (event ){
控制台。log (“文件浏览已触发。” );
});
文件锁
通过单击上载按钮启动上载过程时会触发此事件,并且在上载处理之前锁定(禁用)整个窗口小部件。Cancel锁定文件输入时,仅启用该按钮。其他可用参数包括:
filestack:所选文件对象的数组。
uploadExtraData: uploadExtraData 插件的设置(如果没有设置,将返回一个空对象)。
$ ('#input-id' )。on ('filelock' ,function (event ,filestack ,extraData ){
VAR fstack = filestack 。filter (function (n ){ return n != undefined });
控制台。日志('文件中选择- ' + fstack 。长度);
});
fileunlock
上传过程完成后(成功或出错)会触发此事件。整个小部件被解锁(启用)并恢复到初始状态。其他可用参数包括:
filestack:所选文件对象的数组。
uploadExtraData: uploadExtraData 插件的设置(如果没有设置,将返回一个空对象)。
$ ('#input-id' )。on ('fileunlock' ,function (event ,filestack ,extraData ){
VAR fstack = filestack 。filter (function (n ){ return n != undefined });
控制台。日志('文件中选择- ' + fstack 。长度);
});
filepreremove
在删除预览中的每个缩略图文件和不属于其中的文件之前触发此事件 initialPreview。其他可用参数包括:
id:id预览缩略图帧的HTML标识符(即属性)。
index:缩略图帧的文件索引号。
您可以通过返回false此事件或触发来阻止后续文件删除event.preventDefault()。
$ ('#input-id' )。on ('filepreremove' ,function (event ,id ,index ){
控制台。log ('id =' + id + ',index =' + index );
});
fileremoved
删除预览中的每个缩略图文件和不属于其中的文件后触发此事件 initialPreview。其他可用参数包括:
id:id预览缩略图帧的HTML标识符(即属性)。
index:缩略图帧的文件索引号。
$ ('#input-id' )。on ('fileremoved' ,function (event ,id ,index ){
控制台。log ('id =' + id + ',index =' + index );
});
filebeforedelete
单击每个初始预览缩略图文件的删除按钮时会触发此事件 initialPreview内容集。这个事件不同于filepredelete事件是在启动ajax请求之前触发此事件,并且可以帮助人们验证是否需要启动ajax请求。请参阅删除验证演示1并删除验证演示2以了解用法。请注意,您可以将ajax中止输出作为布尔值或javascript Promise对象返回(之前您可以在演示链接中了解其用法)。此事件可用的其他参数包括:
key:钥匙在里面传递 initialPreviewConfig。对于所选的删除文件。
data:输出 deleteExtraData 宾语。
$ ('#input-id' )。on ('filebeforedelete' ,function (event ,key ,data ){
控制台。log ('Key =' + key );
});
filepredelete
在将ajax删除请求发送到服务器中的每个初始预览缩略图文件之前触发此事件 initialPreview内容集。这个事件不同于filebeforedelete事件是在启动ajax请求后触发此事件,并且可以帮助人们根据验证中止ajax请求。其他可用参数包括:
key:钥匙在里面传递 initialPreviewConfig。对于所选的删除文件。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
data:输出 deleteExtraData 宾语。
$ ('#input-id' )。on ('filepredelete' ,function (event ,key ,jqXHR ,data ){
控制台。log ('Key =' + key );
});
filedeleted
成功完成删除每个初始预览缩略图文件的ajax请求后触发此事件 initialPreview内容集。请参阅删除验证演示以了解用法。其他可用参数包括:
key:钥匙在里面传递 initialPreviewConfig对于将作为POST数据传递给的所选文件url。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
data:输出 deleteExtraData 宾语。
$ ('#input-id' )。on ('filedeleted' ,function (event ,key ,jqXHR ,data ){
控制台。log ('Key =' + key );
});
filepreajax
在提交上载ajax请求之前触发此事件。您可以使用此事件来操纵uploadExtraData在通过ajax提交之前。以下附加参数也是专门提供的,并且仅在通过每个缩略图上传按钮触发上载时才可用。
previewId:预览窗口中每个文件的父缩略图div元素的标识符。
index:文件堆栈中文件的从零开始的索引。
$ ('#input-id' )。on ('filepreajax' ,function (event ,previewId ,index ){
控制台。log ('File pre ajax triggered' );
});
filepreupload
仅在ajax上载时和上载每个缩略图文件之前触发此事件。此事件在之后触发filepreajax并在ajax beforeSend事件中。其他可用参数包括:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的 getFilesCount 方法)。
extra: uploadExtraData 插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
previewId:预览窗口中每个文件的父缩略图div元素的标识符。
index:文件堆栈中文件的从零开始的索引。
$ ('#input-id' )。on ('filepreupload' ,function (event ,data ,previewId ,index ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('文件预上传触发' );
});
fileuploaded
此事件仅针对ajax上载和每个缩略图文件的上载完成后触发。此事件仅针对ajax上载和以下方案触发:
单击每个预览缩略图中的上载图标并成功上载文件时,或者
当你有 uploadAsync设置为true,您已触发批量上传。在这种情况下,在成功上载每个单独的选定文件后触发fileuploaded事件。
此事件可用的其他参数包括:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的 getFilesCount 方法)。
extra: uploadExtraData 插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
previewId:预览窗口中每个文件的父缩略图div元素的标识符。
index:文件堆栈中文件的从零开始的索引。
$ ('#input-id' )。on ('fileuploaded' ,function (event ,data ,previewId ,index ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('File uploaded triggered' );
});
filebatchpreupload
在单击上载按钮后,仅在ajax上载和批量上载(同步和异步上载)之前触发此事件。其他可用参数包括:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的getFilesCount 方法)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
$ ('#input-id' )。on ('filebatchpreupload' ,function (event ,data ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('文件批量预上传' );
});
filebatchuploadsuccess
仅在ajax上载和成功的同步批量上载后触发此事件。此事件仅在ajax上载时触发,并在以下场景中触发:
当您uploadAsync设置为false并且已触发批量上载时。在这种情况下,在成功上载所有文件后触发filebatchuploadsuccess事件。
此事件可用的其他参数是:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的getFilesCount 方法)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
$ ('#input-id' )。on ('filebatchuploadsuccess' ,function (event ,data ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('文件批量上传成功' );
});
filebatchuploadcomplete
此事件仅在ajax上载时触发,并在完成同步OR异步ajax批量上载后触发。其他可用参数包括:
files:文件堆栈数组(如果不可用,则为空对象)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
$ ('#input-id' )。on ('filebatchuploadcomplete' ,function (event ,files ,extra ){
控制台。log ('文件批量上传完成' );
});
filesuccessremove
使用缩略图删除按钮删除成功上传的缩略图后会触发此事件。这通常适用于您showUploadedThumbs设置为 true。其他可用参数包括:
id:缩略图容器元素的HTML ID属性。
$ ('#input-id' )。on ('filesuccessremove' ,function (event ,id ){
if (some_processing_function (id )){
控制台。log ('已成功删除缩略图' );
} else {
返回虚假; //中止删除缩略图
}
});
filedisabled
使用该disable方法禁用文件输入窗口小部件(防止任何修改)时会触发此事件 。
$ ('#input-id' )。on ('filedisabled' ,function (event ){
控制台。log ('文件禁用' );
});
fileenabled
使用该enable 方法启用文件输入窗口小部件(允许修改)时会触发此事件。
$ ('#input-id' )。on ('fileenabled' ,function (event ){
控制台。log ('File enabled' );
});
filesorted
在初始预览中通过拖放对文件进行排序/重新排列时会触发此事件。以下参数将另外作为其键所在的JSON对象发送。
previewId:预览缩略图容器的HTML ID属性
oldIndex:缩略图的旧索引 initialPreview
newIndex:缩略图的新索引 initialPreview
stack:initialPreviewConfig排序后修改。
$ ('#input-id' )。on ('filesorted' ,function (event ,params ){
控制台。日志('文件排序' ,PARAMS 。previewId ,PARAMS 。oldIndex ,PARAMS 。newIndex ,PARAMS 。栈);
});
filezoomshow
单击缩放按钮以在模式对话框中显示内容详细预览时,将触发此事件。以下参数将另外作为其键所在的JSON对象发送。
sourceEvent:Event,触发了源的模态对话框事件show.bs.modal。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomshow' ,function (event ,params ){
控制台。日志('文件缩放显示' ,PARAMS 。sourceEvent的,PARAMS 。previewId ,PARAMS 。情态);
});
filezoomshown
在模态对用户可见之后触发此事件(将等待CSS过渡完成)。以下参数将另外作为其键所在的JSON对象发送。
sourceEvent:Event,触发了源的模态对话框事件show.bs.modal。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomshown' ,function (event ,params ){
控制台。日志('文件变焦'所示,PARAMS 。sourceEvent的,PARAMS 。previewId ,PARAMS 。模态);
});
filezoomhide
通过关闭对话框隐藏模态后触发此事件。以下参数将另外作为其键所在的JSON对象发送。
sourceEvent:Event,触发了源的模态对话框事件show.bs.modal。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomhide' ,function (event ,params ){
控制台。日志('文件变焦隐藏' ,PARAMS 。sourceEvent的,PARAMS 。previewId ,PARAMS 。情态);
});
filezoomhidden
模态完成对用户隐藏后将触发此事件(将等待CSS过渡完成)。以下参数将另外作为其键所在的JSON对象发送。
sourceEvent:Event,触发了源的模态对话框事件show.bs.modal。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomhidden' ,function (event ,params ){
控制台。日志('文件隐藏变焦' ,PARAMS 。sourceEvent的,PARAMS 。previewId ,PARAMS 。情态);
});
filezoomloaded
在模式使用该remote选项加载内容后触发此事件。以下参数将另外作为其键所在的JSON对象发送。
sourceEvent:Event,触发了源的模态对话框事件show.bs.modal。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomloaded' ,function (event ,params ){
控制台。日志('文件加载变焦' ,PARAMS 。sourceEvent的,PARAMS 。previewId ,PARAMS 。情态);
});
filezoomprev
当单击上一个导航按钮以查看上一个文件时(在缩放模式下按下键盘左箭头时也会触发),将在缩放预览模式下触发此事件。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomprev' ,function (event ,params ){
控制台。日志('文件放大之前的' ,PARAMS 。previewId ,PARAMS 。情态);
});
filezoomnext
当单击下一个导航按钮以查看下一个文件时(在缩放模式下按下键盘右箭头时也会触发),将在缩放预览模式下触发此事件。
previewId:string,预览缩略图容器的HTML ID属性
modal:jQuery对象,模态对话框对象
$ ('#input-id' )。on ('filezoomnext' ,function (event ,params ){
控制台。日志('文件变焦下一个' ,PARAMS 。previewId ,PARAMS 。情态);
});
错误事件
可用于文件验证错误的事件。
fileerror
当遇到上载文件的客户端验证错误时,将触发此事件。这允许访问对象“data”作为参数。
data:object / associative数组,包含以下内容:
id:预览缩略图标识符(如果不可用,则为undefined)
index:文件索引/预览缩略图索引(如果不可用,则为undefined)
file:文件对象(如果不可用,则为undefined)
reader:文件读取器实例(如果不可用,则为undefined)
files:文件堆栈数组(如果不可用,则为空对象)。
msg:string,生成错误消息
例:
$ ('#input-id' )。on ('fileerror' ,function (event ,data ,msg ){
控制台。日志(数据。ID );
控制台。日志(数据。索引);
控制台。日志(数据。文件);
控制台。log (数据。读者);
控制台。log (数据。文件);
//得到消息
警报(msg );
});
fileimageresizeerror
在调整图像大小时收到错误或异常时会触发此事件(请参阅 resizeImage属性)。其他可用参数包括:
data:object / associative数组,包含以下内容:
id:预览缩略图标识符(如果不可用,则为undefined)
index:文件索引/预览缩略图索引(如果不可用,则为undefined)
msg:string,生成错误消息
例:
$ ('#input-id' )。on ('fileimageresizeerror' ,function (event ,data ,msg ){
控制台。日志(数据。ID );
控制台。日志(数据。索引);
//得到消息
警报(msg );
});
fileuploaderror
此事件仅针对ajax上载以及主要针对ajax上载遇到上载或文件输入验证错误时触发。此事件仅针对ajax上载和以下方案触发:
单击每个预览缩略图中的上载图标并且文件在上载时遇到验证错误,或者
当您uploadAsync设置为true并且已触发批量上载时。在这种情况下,在任何选定文件面临上载验证错误后触发fileuploaderror事件。
此事件可用的其他参数是:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
id:预览缩略图标识符(如果不可用,则为undefined)
index:文件索引/预览缩略图索引(如果不可用,则为undefined)
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的getFilesCount 方法)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
msg:string,生成错误消息
$ ('#input-id' )。on ('fileuploaderror' ,function (event ,data ,msg ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('文件上传错误' );
//得到消息
警报(msg );
});
filebatchuploaderror
仅在ajax上载时触发此事件,并且在同步批量上载遇到上载验证错误之后触发此事件。此事件仅在ajax上载时触发,并在以下场景中触发:
当您uploadAsync设置为false并且已触发批量上载时。在这种情况下,filebatchuploaderror事件在任何文件面临上载错误后触发,或者您通过服务器操作JSON响应返回错误。
此事件可用的其他参数是:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的getFilesCount 方法)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
msg:string,生成错误消息
$ ('#input-id' )。on ('filebatchuploaderror' ,function (event ,data ,msg ){
var form = data 。表格,文件= 数据。文件,额外= 数据。额外的,
响应= 数据。响应,读者= 数据。读者;
控制台。log ('文件批量上传错误' );
//得到消息
警报(msg );
});
filedeleteerror
当删除initialPreview内容集中的每个缩略图文件时遇到错误时,将触发此事件 。其他可用参数包括:
data:这是一个数据对象(关联数组),它发送以下信息,其键是:
id:预览缩略图标识符(如果不可用,则为undefined)
index:文件索引/预览缩略图索引(如果不可用,则为undefined)
extra:deleteExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
msg:string,生成错误消息
$ ('#input-id' )。on ('filedeleteerror' ,function (event ,data ,msg ){
控制台。log ('文件删除错误' );
//得到消息
警报(msg );
});
filefoldererror
将文件夹或多个文件夹拖放到文件预览放置区时遇到错误时会触发此事件。其他可用参数包括:
folders:int,删除的文件夹数。
msg:string,生成错误消息
$ ('#input-id' )。on ('filefoldererror' ,function (event ,folders ,msg ){
控制台。log ('文件夹丢失错误' );
//得到消息
警报(msg );
});
filecustomerror
通过从源事件返回错误对象,用户从其他事件之一手动触发此事件。参考事件处理部分了解详情。其他可用参数包括:
data 这是一个发送以下信息的数据对象(关联数组),其键是:
form:FormData,通过XHR2传递的对象(如果不可用则为空对象)。
files:array,文件堆栈数组(如果不可用则为空对象)。
filenames:array,堆栈数组中每个文件的客户端文件名(如果不可用,则为空对象)。
filescount:int,所选文件的数量包括上传(基本上会返回输出的getFilesCount 方法)。
extra:uploadExtraData插件的设置(如果不可用,则为空对象)。
response:通过ajax响应发送的数据(如果不可用则为空对象)。
reader:FileReader实例(如果可用)。
jqXHR:jQuery XMLHttpRequest用于此事务的对象(如果可用)。
msg:string,生成错误消息
$ (“#input” )。on ('filecustomerror' ,function (event ,params ,msg ){
控制台。日志(PARAMS 。ID );
控制台。日志(PARAMS 。指数);
控制台。日志(PARAMS 。数据);
//得到消息
警报(msg );
});
事件操纵
在v4.1.8发行版中,您可以通过返回大多数事件的数据并将其用于高级处理来操纵事件并通过其他事件添加自定义验证。事件部分中列出的大多数事件都支持此功能,但以下事件除外。
fileclear
filecleared
filereset
fileerror
fileuploaderror
filebatchuploaderror
filedeleteerror
filefoldererror
filecustomerror
fileuploaded
filebatchuploadcomplete
filebatchuploadsuccess
对于除上述事件之外的所有事件,您可以设置自定义验证错误,该错误将在启动上载之前触发。
这将使您能够添加其他自定义验证,以增强fileinput,以用于无数场景。它将允许与任何的FileInput事件返回一个关联对象(除了上述以外的事件),例如一个能力change,fileselect,filepreupload,filebatchpreupload 等。
该对象可以返回以下键:
message:string,上载前显示的验证错误消息。如果设置了此项,则插件将在调用时自动中止上载,并将其显示为错误消息。例如,您可以使用此属性来读取文件并执行自己的自定义验证。
data:object,中止的附加数据的可选关联数组,您可以稍后传递以供使用。
例
第1步:您可以触发例如中止错误filepreupload
$ ('#input' )。on ('filepreupload' ,function (event ,data ,previewId ,index ,jqXHR ){
//进行验证并返回如下错误
if (customValidationFailed ){
返回{
消息:'你不被允许这样做' ,
数据:{ key1 :'Key 1' ,detail1 :'Detail 1' }
};
}
});
以上中止将在上传时(ajax上传)或表单提交时触发(对于非ajax上传)。
第2步:通过捕获filecustomerror事件来中止读取其他数据
$ ('#input' )。on ('filecustomerror' ,function (event ,params ){
// params.abortData将包含传递的其他中止数据
// params.abortMessage将包含传递的已中止错误消息
});
如前所述,filecustomerror以下事件不支持上述提升功能:
fileclear
filecleared
filereset
fileerror
fileuploaderror
filebatchuploaderror
filedeleteerror
filecustomerror
fileuploaded
filebatchuploadcomplete
filebatchuploadsuccess