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插件实现表单验证实例

jQuery插件 -- 表单验证插件jquery.validate.js

jQuery表单插件

jquery插件-表单验证插件-validator对象