Methods: Added require_from_group

sfreytag · jzaefferer · commit 2f976f3876a2 · 2014-01-15T15:30:14.000+01:00
Closes gh-5
diff --git a/entries/require_from_group-method.xml b/entries/require_from_group-method.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0"?>
+<entry name="require_from_group" type="method" return="Boolean">
+	<title>require_from_group method</title>
+	<desc>Ensures a given number of fields in a group are complete.</desc>
+	<longdesc>
+		In the options passed to the rule, supply the minimum number of fields
+		within the group that must be complete and a selector to define the
+		group. Then apply this rule to all the fields within the group.
+		The form then cannot be submitted until at least the minimum number have
+		been completed.
+	</longdesc>
+	<example>
+		<desc>Within a group of three phone numbers, ensure at least one is complete.</desc>
+		<code><![CDATA[
+$( "#myform" ).validate({
+  rules: {
+    mobile_phone: {
+      require_from_group: [1, ".phone-group"]
+    },
+    home_phone: {
+      require_from_group: [1, ".phone-group"]
+    },
+    work_phone: {
+      require_from_group: [1, ".phone-group"]
+    }
+  }
+});
+]]></code>
+<html><![CDATA[
+<label for="mobile_phone">Mobile phone: </label>
+<input class="left phone-group" id="mobile_phone" name="mobile_phone">
+<br/>
+<label for="home_phone">Home phone: </label>
+<input class="left phone-group" id="home_phone" name="home_phone">
+<br/>
+<label for="work_phone">Work phone: </label>
+<input class="left phone-group" id="Work_phone" name="work_phone">
+<br/>
+<input type="submit" value="Validate!">
+]]></html>
+	</example>
+	<category slug="methods"/>
+</entry>
diff --git a/pages/documentation.md b/pages/documentation.md
@@ -129,6 +129,7 @@ Some more methods are provided as add-ons, and are currently included in additio
 * [`accept` - Makes a file upload accept only specified mime-types.](/accept-method)
 * [`extension` - Makes the element require a certain file extension.](/extension-method)
 * [`phoneUS` - Validate for valid US phone number.](/phoneUS-method)
+* [`require_from_group` - Ensures a given number of fields in a group are complete.](/require_from_group-method)
 
 # [General Guidelines](/reference)
 
