jQuery表单插件
Posted
tags:
中文标题:jQuery表单插件 原文标题:jQuery Form Plugin 项目评级:Star:5200 Fork:2200 下载地址:https://github.com/jquery-form/form 详情介绍jQuery表单
概述
jQuery表单插件允许您轻松而不引人注目地升级HTML表单以使用AJAX。主要方法ajaxForm和ajaxSubmit从表单元素收集信息,以确定如何管理提交流程。这两种方法都支持许多选项,使您能够完全控制数据的提交方式。
不需要特殊的标记,只需要一个普通的表单。用AJAX提交表单没有比这更容易的了!
社区
想为jQuery Form贡献力量吗?令人惊叹的有关更多信息,请参阅贡献。
行为准则
请注意,此项目发布时带有参与者行为准则,以确保此项目是一个欢迎所有人参与的地方。通过参与此项目,您同意遵守其条款。
需要拉取请求
与jQuery 3完全兼容所需的增强功能
jQuery3删除了许多长期以来不推荐使用的功能。其中一些仍在由jQuery Form使用。
非常感谢Pull请求和帮助更新jQuery Form以与jQuery 3兼容。
有关更多信息,请参阅第544期。
兼容性
下载
CDN公司
API
jqXHR公司
jqXHR对象存储在元素<em>数据ajaxSubmit后都有jqxhr
键
呼叫它可以这样访问:
ajaxForm(选项)
通过添加所有必要的事件侦听器来准备要通过AJAX提交的表单。它不提交表单。在文档的ready
功能中使用ajaxForm
来准备用于AJAX提交的现有表单,或者使用delegation
选项来处理尚未添加到DOM中的表单。
当您希望插件为您管理所有事件绑定时,请使用ajaxForm。
ajaxSubmit(选项)
立即通过AJAX提交表单。在最常见的用例中,这是在用户单击表单上的提交按钮时调用的。
如果您想将自己的提交处理程序绑定到表单,请使用ajaxSubmit。
选项
注意:所有标准的$.ajax选项都可以使用。
串行化之前
在表单序列化之前调用的回调函数。提供了在检索表单值之前对其进行操作的机会。从回调返回false
将阻止表单提交。回调由两个参数调用:jQuery包装的表单对象和options对象。
提交之前
在表单提交之前调用了回调函数。从回调返回false
将阻止表单提交。回调由三个参数调用:数组格式的表单数据、jQuery包装的表单对象和options对象。
在窗体取消绑定之前
在表单事件解除绑定并再次绑定之前调用的回调函数。提供了在重新装入事件之前操作窗体的机会。回调由两个参数调用:jQuery包装的表单对象和options对象。
过滤
在处理字段之前调用了回调函数。这提供了一种过滤元件的方法。
clearForm(清除表单)
布尔标志,指示如果提交成功,是否应清除表单
数据
包含额外数据的对象,这些数据应与表单一起提交。
data: key1: 'value1', key2: 'value2'
数据库类型
应为响应的数据类型。其中之一:null、“xml”、“script”或“json”。dataType选项提供了一种指定应如何处理服务器响应的方法。这直接映射到jQuery的dataType方法。支持以下值:
代表团
true以支持活动委派
需要jQuery v1.7+
错误
已弃用
发生错误时要调用的回调函数。
强制同步
仅当显式使用iframe选项或在不支持XHR2的浏览器上上传文件时适用。
设置为true
可删除上传文件时在发布表单之前的短暂延迟。延迟用于允许浏览器在执行本机表单提交之前呈现DOM更新。这提高了向用户显示通知时的可用性,例如“请稍候…”
iframe(iframe)
布尔标志,指示表单是否应始终将服务器响应指向iframe,而不是在可能的情况下利用XHR。
iframeSrc公司
使用iframe时应用于iframe的src属性的字符串值。
iframeTarget(iframeTarget)
标识要用作文件上载的响应目标的iframe元素。默认情况下,插件将创建一个临时iframe元素,以在上传文件时捕获响应。如果您愿意,此选项允许您使用现有的iframe。使用此选项时,插件不会尝试处理来自服务器的响应。
方法
用于请求的HTTP方法(例如“POST”、“GET”、“PUT”)。
替换目标
可与目标选项一起使用(可选)。如果应替换目标,则设置为true;如果仅应替换目标内容,则设置设置为false。
重置窗体
布尔标志,指示如果提交成功,是否应重置表单
语义的
布尔标志,指示数据是否必须按严格的语义顺序提交(较慢)。注意,除了type="image"
的输入元素外,范式序列化是按语义顺序进行的。只有当服务器有严格的语义要求并且表单包含type="image"
的输入元素时,才应将语义选项设置为true。
成功
已弃用
表单提交后要调用的回调函数。如果提供了“success”回调函数,则会在服务器返回响应后调用该函数。它被传递以下标准jQuery参数:
目标
标识页面中要使用服务器响应更新的元素。该值可以指定为jQuery选择字符串、jQuery对象或DOM元素。
类型
用于请求的HTTP方法(例如“POST”、“GET”、“PUT”)。
method
选项的别名。如果两者都存在,则被method
值覆盖。
上传进度
要使用上载进度信息调用的回调函数(如果浏览器支持)。回调传递了以下参数:
网址
表单数据将提交到的URL。
实用程序方法
表单序列化
将表单序列化为查询字符串。此方法将返回一个字符串,格式为:name1=value1&name2=value2
字段序列化
将字段元素序列化为查询字符串。当您只需要序列化表单的一部分时,这很方便。此方法将返回一个格式为name1=value1&name2=value2
的字符串
字段值
返回数组中匹配集中元素的值。此方法总是返回一个数组。如果无法确定有效值,则数组将为空,否则它将包含一个或多个值。
重置窗体
通过调用表单元素的本机DOM方法将表单重置为其原始状态。
clearForm(清除表单)
清除表单元素。此方法清空所有文本输入、密码输入和文本区域元素,清除任何选择元素中的选择,并取消选中所有单选和复选框输入。它不会清除隐藏字段值。
clear字段
清除选定的字段元素。当您只需要清除表单的一部分时,这很方便。
文件上传
Form插件支持在支持这些功能的浏览器上使用XMLHttpRequest Level 2和FormData对象。截至今日(2012年3月),包括Chrome、Safari和Firefox。在这些浏览器(以及未来的Opera和IE10)上,文件上传将通过XHR对象无缝进行,并且随着上传的进行,进度更新可用。对于较旧的浏览器,使用了一种涉及iframe的回退技术。更多信息
贡献者
本项目已从github.com/malsup/form转来,由Mike Alsup提供。
详见贡献者。
许可证
本项目根据LGPLv2.1(或更高版本)或麻省理工学院许可证获得双重许可:
3.51版的附加文档和示例,位于:http://malsup.com/jquery/form/
jQuery插件 -- Form表单插件jquery.form.js
JavaScript之jQuery-7 jQuery 使用插件(使用插件日历插件表单验证插件)
jQuery常用插件与jQuery使用validation插件实现表单验证实例