\n * Guard elements with the given selector when the form is guarded. This is the way to add\n * new guards to form inputs. It returns a Guards\n * instance which has chainable methods to define the attributes of the guard.\n *
\n *
\n * Required field\n *
\n * Only values found in the given list are considered valid. Anything else triggers a failure.\n * This guard requires an array parameter of the valid values.\n *
\n *\n *\n *
\n * Allowed values: red, yellow, blue\n *
\n * As of version 1.3.1, the allowed words can be specified via an object with a string property\n * named words delimited by spaces by default, or delimited with the\n * delimiter property. This is primarily to support the data attributes\n * form of guards.\n *
\n *
\n * Allowed values: red, yellow, blue\n *
\n *
\n * Allowed values: United States, Canada\n *
\n * Always fail, no matter what. For this guard to pass, either the guard must be removed, or\n * the element(s) guarded must be removed. No parameters are accepted.\n *
\n *\n *\n *
\n * Always fails, no matter what\n *
\n * This is a grouped guard where every field must have a different value.\n *
\n *\n *\n *
\n *
\n * Each value must be unique\n *
\n * Guard against specific values. This guard requires an array parameter\n * of the invalid values.\n *
\n *\n *\n *
\n * Disallowed values: red, yellow, blue\n *
\n * As of version 1.3.1, the disallowed words can be specified via an object with a string property\n * named words delimited by spaces by default, or delimited with the\n * delimiter property. This is primarily to support the data attributes\n * form of guards.\n *
\n *
\n * Disallowed values: red, yellow, blue\n *
\n *
\n * Disallowed values: United States, Canada\n *
\n * Guard for a US date. Month and day value validations\n * exist, though may not conver all invalid dates (so,\n * 13/32/2013 is invalid, but 2/31/2013 might not properly\n * fail at this point in time). An empty value is\n * considered valid.\n *
\n *\n *\n *
\n * US date of any value\n *
\n * Guard for a US time. Military time is not currently\n * supported. An empty value is considered valid.\n *
\n *\n *\n *
\n * US time of any value\n *
\n * Guard for a valid email address. An empty value is ignored, so only once a value exists will\n * this guard start checking for an email address. An optional argument of\n * { allowDisplay: true } is allowed that may specify whether display emails of the\n * form John Doe <john@example.com> are allowed.\n *
\n *
\n * Email address of the form \"john@example.com\"\n *
\n *
\n * Email address of the form \"John Doe <john@example.com>\"\n *
\n * Guard for a floating point number. Optionally, an object parameter may be passed with\n * min and/or max. Min will restrict the minimum value, while\n * max restricts the maximum. An empty value is considered valid.\n *
\n *
\n * A number of any value\n *
\n *
\n * A number no smaller than -5.5\n *
\n *
\n * A number no bigger than 42\n *
\n *
\n * A number from 0 to 10\n *
\n * Guard for an integer number. Optionally, an object parameter may be passed with\n * min and/or max. Min will restrict the minimum value, while\n * max restricts the maximum. An empty value is considered valid.\n *
\n *
\n * An integer of any value\n *
\n *
\n * An integer no smaller than -5\n *
\n *
\n * An integer no bigger than 42\n *
\n *
\n * An integer from 0 to 10\n *
\n * Guard for a US dollar amount. Optionally, an object parameter may be passed with\n * min and/or max. Min will restrict the minimum value, while\n * max restricts the maximum. An empty value is considered valid.\n *
\n *
\n * US money of any value\n *
\n *
\n * US money no smaller than -$5.50\n *
\n *
\n * US money no bigger than $42.02\n *
\n *
\n * US money from $0 to $10\n *
\n * Never fail, no matter what. For this guard to fail, it must be manually triggered via\n * guard.triggerError(selector).\n * This guard can be useful for marking a field as having an error immediately when the page\n * loads (such as for a server detected error).\n *
\n *
\n * Never fails, except manually\n *
\n * This is a grouped guard where a single field of all the selected fields must have a value.\n *
\n *\n *\n *
\n *
\n * One value is required\n *
\n * The guarded field is considered valid if no value is given, or if the value given appears\n * to be a valid US phone number. The number must include an area code. Whitespace is ignored.\n *
\n *\n *\n *
\n * A valid US phone number like (555) 555-1234\n *
\n * These guarded fields must match the provided regex to pass. An empty value is considered valid.\n *
\n *\n *\n *
\n * abc with 1-3 digits is required, like 'abc123'\n *
\n * As of version 1.3.1, the regex can be specified via an object with a string property named\n * pattern. This is primarily to support the data attributes\n * form of guards.\n *
\n *
\n * abc with 1-3 digits is required, like 'abc123'\n *
\n * These guarded fields must have a value to pass. Only whitespace is not considered a value.\n * If no named or custom guard is defined, this is the default guard used.\n *
\n *\n *\n *
\n * A value is required\n *
\n *
\n * A value is required\n *
\n * This is a grouped guard where every field must have the same value. For example, this guard can\n * be used to implement a password confirmation field.\n *
\n *\n *\n *
\n *
\n * Each value must be the same\n *
\n * Validate the length of the string provided. This requires an object parameter with\n * min and/or max. Min will restrict the minimum length, while\n * max restricts the maximum length.\n *
\n *
\n * A string with at lease 3 characters\n *
\n *
\n * A string with no more than 7 characters\n *
\n *
\n * A string with at least 2 characters and no more than 5\n *
\n * This version of guards.js library as a string, like \"1.0.0\".\n *
\n * Name a guard. This behaves the same way as\n * $.guard(selector), except it uses\n * the parameter to define a named guard with the given name, instead of defining a new\n * guard affecting the given selector. Any attributes applied to it will be passed on to\n * any guards that utilize this named guard. A named guard may be utilized by passing the\n * name on to the using method.\n *
\n *
\n * Anything except 'test'\n *
\n * Insert a style element to the document head that will style guard errors and invalid fields.\n * This will default to styling .invalid-field with a background color of\n * #ffff66 and .error-message with a color of #ff0000\n * and a left margin of 10px.\n *
\n * There are 2 optional arguments for this method. The first is an optional css scope to restrict\n * the styling affects with. The second is an object expected to contain a field\n * and/or message property with css styles desired for that aspect of the styling.\n * The field property will add styling for invalid fields while the message\n * property will add styling for error messages. The properties of these objects may contain any\n * key that is a valid css attribute, with an appropriate value.\n *
\n * \n *
\n *\n * Guard inputs with the specified name guard, or with a custom function. If the first argument\n * provided is a string, it must correspond to a named guard. This may be one of the\n * default named guards, or a guard named via\n * $.guards.name(name). Additional arguments\n * may be given as options to the named guard. All attributes specified by the named guard\n * will be copied over when the using method is invoked.\n *
\n * Alternatively, a function may be provided as the custom guard function. This function is invoked\n * when guards are being tested with the value of the element guarded, and the element being\n * guarded. If the guard is grouped, it will be an array of values with the corresponding array\n * of elements.\n *
\n *\n *\n *
\n * Required field\n *
\n *
\n * Field must not be 'invalid'\n *
\n *
\n *
\n * One must be 'test'\n *
\n * Specify a precondition for this guard. A parameter is required with the precondition\n * function. This function accepts the element and element value as the parameters, like\n * a custom guard function. The precondition is executed before the guard when any given\n * input is about to be guarded. If the precondition returns false explicitly, the guard\n * will not be executed and the field will be considered valid. Any other return value\n * means the precondition passed (even no return). If the guard is grouped, the parameters\n * will be the array of values and elements (like for a custom guard function).\n *
\n *\n *\n * \n *
\n *
\n * Guarded with required if the checkbox is checked\n *
\n * Mark this guard as being grouped. A grouped guard will guard all affected elements\n * at once, instead of individually. Each guarded element with an error will still be marked\n * as an error, but only one error message will be added. Custom guard functions will receive\n * all elements and their values at once instead of individually. By default, a guard is\n * not considered grouped. Name guards, however, carry their grouped status on, so a guard\n * using oneRequired,\n * different, and\n * same will be grouped by default.\n *
\n * If no argument is given, the guard will be marked as grouped, otherwise the parameter is\n * exoected to be a boolean indicating whether the guard should be grouped.\n *
\n *\n *\n *
\n *
\n * These are effectively guarded with 'required' now\n *
\n *
\n *
\n * One must be 'test'\n *
\n * Change the tag type that surrounds the error message. By default, a span tag is\n * used.\n *
\n * \n *
\n *\n * Change what class is used for error messages added due to failed guards. By default, the\n * error element has the class error-message, but that class will not be userd\n * if a different one is specified with this method.\n *
\n * \n *
\n *\n *\n * \n *
\n *\n * Customize the error message displayed if the guard fails. The\n * default named guards\n * have messages already defined, but they may be changed with this method.\n *
\n * \n *
\n *\n * Change what class is added to invalid fields. By default, the invalid class added is\n * invalid, but that class will not be added if a different one is specified\n * with this method.\n *
\n * \n *
\n *\n *\n * \n *
\n *\n * Specify where the error will be placed in the DOM when this guard fails. The argument can be\n * a jQuery selector, element, set of elements, jQuery selected set of elements, or a function.\n * If the argument is anything except a function, it will be passed to the jQuery function and\n * the first element will be retrieved and used as the place to append the error message.\n * If it is a function, the function may either insert the error message itself, or return the\n * location to place the error message.\n *
\n *\n *\n * When provided a function, the function will be called when an error has happened. The function's\n * this reference will be set to the error element (or set of elements in the case of\n * a grouped guard) that had the error. The argument will be the error message element that will be\n * appended. When false is returned, the function is expected to have inserted the\n * provided error message in the DOM. Otherwise, the return value is expected to be a jQuery\n * selector, element, set of elements or jQuery selected set of elements of which the first will\n * have the error element appended to it.\n *
\n * The default behavior is to append the error message after the last error element that is guarded.\n * If the last element is a radio button or checkbox, it will be appended after the first sibling\n * of the radio button or checkbox, which is expected to be the label for the radio button or\n * checkbox. If there is already a guard error message there, it will be appended after the last\n * guard error message (so guard messages show up in the proper order as they are specified).\n *
\n *\n *\n * \n * Error message targeted with selector:\n * \n *
\n *\n *\n * \n * Error message targeted with function:\n * \n *
\n *\n *\n * \n * Error message inserted manually:\n * \n *
\n *\n * When a guard triggers an error, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the individual\n * form fields with the \"guardError\" event.\n *
\n *\n *\n * If preventDefault() is called on the event, then the error will be prevented. If\n * stopPropagation() or stopImmediatePropagation() is called on the event, then no other event\n * handlers will receive the event (including jQuery event handlers).\n *
\n *\n *\n *
\n * Alerts on error.\n *
\n * \n *
\n *\n * When a guard triggers an error, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the top level\n * form element with the \"guardFormError\" event.\n *
\n *\n *\n * If preventDefault() is called on the event, then the error will be prevented. If\n * stopPropagation() or stopImmediatePropagation() is called on the event, then no other event\n * handlers will receive the event (including jQuery event handlers).\n *
\n *\n *\n *
\n * Alerts on error.\n *
\n * \n *
\n *\n * When a guard triggers an error, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the individual\n * form fields with the \"afterGuardError\" event. This event is triggered after the error has\n * been applied, unlike the guardError and guardFormError events.\n *
\n *\n *\n * Calling preventDefault() has no effect. If stopPropagation() or stopImmediatePropagation() is\n * called on the event, then no other event handlers will receive the event (including jQuery\n * event handlers).\n *
\n *\n *\n *
\n * Alerts on error.\n *
\n * \n *
\n *\n * When a guard triggers an error, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the top level\n * form element with the \"afterGuardFormError\" event. This event is triggered after the error\n * has been applied, unlike the guardError and guardFormError events.\n *
\n *\n *\n * Calling preventDefault() has no effect. If stopPropagation() or stopImmediatePropagation() is\n * called on the event, then no other event handlers will receive the event (including jQuery\n * event handlers).\n *
\n *\n *\n *
\n * Alerts on error.\n *
\n * \n *
\n *\n * When a guard error is cleared, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the individual\n * form fields with the \"clearGuardError\" event.\n *
\n *\n *\n * If preventDefault() is called on the event, then the error will not be cleared. If\n * stopPropagation() or stopImmediatePropagation() is called on the event, then no other event\n * handlers will receive the event (including jQuery event handlers).\n *
\n *\n *\n *
\n * Alerts when errors are cleared.\n *
\n * \n *
\n *\n * When a guard error is cleared, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the top level\n * form element with the \"clearGuardFormError\" event.\n *
\n *\n *\n * If preventDefault() is called on the event, then the error will not be cleared. If\n * stopPropagation() or stopImmediatePropagation() is called on the event, then no other event\n * handlers will receive the event (including jQuery event handlers).\n *
\n *\n *\n *
\n * Alerts when errors are cleared.\n *
\n * \n *
\n *\n * When a guard error is cleared, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the individual\n * form fields with the \"afterClearGuardError\" event. This event is triggered after the error has\n * been cleared, unlike the clearGuardError and clearGuardFormError events.\n *
\n *\n *\n * Calling preventDefault() has no effect. If stopPropagation() or stopImmediatePropagation() is\n * called on the event, then no other event handlers will receive the event (including jQuery\n * event handlers).\n *
\n *\n *\n *
\n * Alerts when errors are cleared.\n *
\n * \n *
\n *\n * When a guard error is cleared, the callback provided to this function will be called with an\n * event object. This event can also be captured by binding for jQuery events on the top level\n * form element with the \"afterClearGuardFormError\" event. This event is triggered after the error\n * has been cleared, unlike the clearGuardError and clearGuardFormError events.\n *
\n *\n *\n * Calling preventDefault() has no effect. If stopPropagation() or stopImmediatePropagation() is\n * called on the event, then no other event handlers will receive the event (including jQuery\n * event handlers).\n *
\n *\n *\n *
\n * Alerts when errors are cleared.\n *
\n * \n *
\n *\n * Exlicitly trigger an error for this guard on all elements provided to this function.\n * The argument provided is wrapped as a jQuery object, so it may be a selector, jQuery\n * object, element, or array of elements (or anything valid for a jQuery object). Note\n * that the elements provided will have the guard applied, regardless of whether they\n * match the guard selector.\n *
\n *\n *\n * This method may alternatively be invoked with no arguments. If this is done, the\n * selector used with the guard is used to select the elents to trigger the guard error.\n *
\n *\n *\n *
\n * Triggered with a different selector\n *
\n *
\n * Triggered using the guard's selector\n *
\n * Clear any guard errors present on the form fields within the selected form (or other\n * containing element around form elements), and then test each element in order against\n * each guard in the order the guards were defined. If any of the fields had an error,\n * focus the first such field.\n *
\n *\n *\n * As of version 1.5.1, directly selected form fields will be guarded as well. The\n * order of evaluating selected fields is undefined, as it is dependent on jQuery.\n *
\n *\n *\n * \n *
\n *\n * \n *
\n *\n * \n *
\n *\n * Clear any guard errors on the selected elements.\n *
\n *\n *\n * \n *
\n *\n * \n *
\n *\n * Enable guards for a given selector. This will turn on live submit events to guard\n * the children of the selected forms/elements. Since these are live events, this\n * function need not be called when the elements actually exist (so they need not be in\n * a DOM onready handler).\n *
\n *\n *\n * Disable guards that was previously enabled for the given selector.\n *
\n *\n *\n * Enable live guards for a given selector. This will turn on live submit, change and blur\n * events to guard the children of the selected forms/elements. Since these are live events,\n * this function need not be called when the elements actually exist (so they need not be in\n * a DOM onready handler).\n *
\n *\n *\n * Disable live guards that was previously enabled for the given selector.\n *
\n *\n *\n * This is a jQuery selector that can be used to select elements that currently have an error.\n *
\n *\n *\n * \n *
\n *\n *\n * \n *
\n *\n *
\n * \n *