jQuery validator plugin之Plugin Method
.validate()
-
validate( [options ] )
-
optionsType: Object
-
debug (default:
false
)Type: BooleanEnables debug mode. If true, the form is not submitted and certain errors are displayed on the console (will check if awindow.console
property exists). Try to enable when a form is just submitted instead of validation stopping the submit. -
submitHandler (default:
native form submit
)Type: Function()Callback for handling the actual submit when the form is valid. Gets the form and the submit event as the only arguments. Replaces the default submit. The right place to submit a form via Ajax after it is validated. -
invalidHandlerType: Function()Callback for custom code when an invalid form is submitted. Called with an event object as the first argument, and the validator as the second.
-
ignore (default:
":hidden"
)Type: SelectorElements to ignore when validating, simply filtering them out. jQuery's not-method is used, therefore everything that is accepted by not() can be passed as this option. Inputs of type submit and reset are always ignored, so are disabled elements. -
rules (default:
rules are read from markup (classes, attributes, data)
)Type: ObjectKey/value pairs defining custom rules. Key is the name of an element (or a group of checkboxes/radio buttons), value is an object consisting of rule/parameter pairs or a plain String. Can be combined with class/attribute/data rules. Each rule can be specified as having a depends-property to apply the rule only in certain conditions. See the second example below for details. -
messages (default:
the default message for the method used
)Type: ObjectKey/value pairs defining custom messages. Key is the name of an element, value the message to display for that element. Instead of a plain message, another map with specific messages for each rule can be used. Overrides the title attribute of an element or the default message for the method (in that order). Each message can be a String or a Callback. The callback is called in the scope of the validator, with the rule's parameters as the first argument and the element as the second, and must return a String to display as the message. -
groupsType: ObjectSpecify grouping of error messages. A group consists of an arbitrary group name as the key and a space separated list of element names as the value. Use errorPlacement to control where the group message is placed.
-
normalizerType: Function()Prepares/transforms the elements value for validation.
See normalizer docs for more details. -
onsubmit (default:
true
)Type: BooleanValidate the form on submit. Set to false to use only other events for validation. -
onfocusoutValidate elements (except checkboxes/radio buttons) on blur. If nothing is entered, all rules are skipped, except when the field was already marked as invalid.
-
onkeyupValidate elements on keyup. As long as the field is not marked as invalid, nothing happens. Otherwise, all rules are checked on each key up event. Set to false to disable.
-
-
-
-
- onclick
-
- focusInvalid (default:
true
)
-
focusCleanup (default:
false
)Type: BooleanIf enabled, removes the errorClass from the invalid elements and hides all error messages whenever the element is focused. Avoid combination with focusInvalid. -
errorClass (default:
"error"
)Type: StringUse this class to create error labels, to look for existing error labels and to add it to invalid elements. -
validClass (default:
"valid"
)Type: StringThis class is added to an element after it was validated and considered valid. -
errorElement (default:
"label"
)Type: StringUse this element type to create error messages and to look for existing error messages. The default, "label", has the advantage of creating a meaningful link between error message and invalid field using the for attribute (which is always used, regardless of element type). -
wrapper (default:
window
)Type: StringWrap error labels with the specified element. Useful in combination with errorLabelContainer to create a list of error messages. -
errorLabelContainerType: SelectorHide and show this container when validating.
-
errorContainerType: SelectorHide and show this container when validating.
-
showErrorsType: Function()A custom message display handler. Gets the map of errors as the first argument and an array of errors as the second, called in the context of the validator object. The arguments contain only those elements currently validated, which can be a single element when doing validation on focusout or keyup. You can trigger (in addition to your own messages) the default behaviour by calling this.defaultShowErrors().
-
errorPlacement (default:
Places the error label after the invalid element
)Type: Function()Customize placement of created error labels. First argument: The created error label as a jQuery object. Second argument: The invalid element as a jQuery object. -
successIf specified, the error label is displayed to show a valid element. If a String is given, it is added as a class to the label. If a Function is given, it is called with the label (as a jQuery object) and the validated input (as a DOM element). The label can be used to add a text like "ok!".
-
highlight (default:
Adds errorClass (see the option) to the element
)Type: Function()How to highlight invalid fields. Override to decide which fields and how to highlight. -
unhighlight (default:
Removes the errorClass
)Type: Function()Called to revert changes made by option highlight, same arguments as highlight. -
ignoreTitle (default:
false
)Type: BooleanSet to skip reading messages from the title attribute, helps to avoid issues with Google Toolbar; default is false for compability, the message-from-title is likely to be completely removed in a future release.
This method sets up event handlers for submit, focus, keyup, blur and click to trigger validation of the entire form or individual elements.
Each one can be disabled, see the onxxx options (onsubmit, onfocusout, onkeyup, onclick).
focusInvalid focuses elements when submitting an invalid form.
Use the debug option to ease setting up validation rules, it always prevents the default submit, even when script errors occur.
Use submitHandler to implement your own form submit, eg. via Ajax.
Use invalidHandler to react when an invalid form is submitted.
Use rules and messages to specify which elements to validate, and how.
See rules() for more details about specifying validation rules.
Use errorClass, errorElement, wrapper, errorLabelContainer, errorContainer, showErrors, success, errorPlacement, highlight, unhighlight, and ignoreTitle to control how invalid elements and error messages are displayed.
.valid()
Checks whether the selected form is valid or whether all selected elements are valid.
.rules()
Read, add and remove rules for an element.
Returns the validations rules for the first selected element or Adds the specified rules and returns all rules for the first matched element
Requires that the parent form is validated,
that is, $( "form" ).validate() is called first or Removes the specified rules and returns all rules for the first matched element.
There are several ways to specify validation rules.
- Validation methods with parameters can be specified as attributes (recommended)
- Validation methods without parameters can be specified as classes on the element
- Both can be specified using the rules-option of the validate()-method
- Both rules and messages can be specified using data attributes, using
data-msg
(a generic, not-method specific message),data-msg-[method]
anddata-rule-[method]
.
When setting, the rules can also contain a messages-object, specifying custom messages for existing or added rules.
-
rulesType: ObjectThe rules to add. Accepts the same format as the rules-option of the validate-method.
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· 没有源码,如何修改代码逻辑?
· NetPad:一个.NET开源、跨平台的C#编辑器
· 面试官:你是如何进行SQL调优的?
2017-12-27 facebook ads api
2017-12-27 Kubernetes命令
2017-12-27 Docker 命令