aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/cookbook/form.ngdoc
diff options
context:
space:
mode:
authorIgor Minar2011-06-06 08:50:35 -0700
committerIgor Minar2011-06-06 22:52:02 -0700
commit7f1e2e48467f80cc083d24b44f088620e4e7bcb6 (patch)
tree731a91366c5780985be6d4c5ddbe34e307d5cb70 /docs/content/cookbook/form.ngdoc
parent5533e48dead5cff3107e72ee80bf0f19df77c1e9 (diff)
downloadangular.js-7f1e2e48467f80cc083d24b44f088620e4e7bcb6.tar.bz2
new batch of docs
Diffstat (limited to 'docs/content/cookbook/form.ngdoc')
-rw-r--r--docs/content/cookbook/form.ngdoc37
1 files changed, 28 insertions, 9 deletions
diff --git a/docs/content/cookbook/form.ngdoc b/docs/content/cookbook/form.ngdoc
index 9ccad1c2..6f6447c8 100644
--- a/docs/content/cookbook/form.ngdoc
+++ b/docs/content/cookbook/form.ngdoc
@@ -3,11 +3,14 @@
@name Cookbook: Form
@description
+
A web application's main purpose is to present and gather data. For this reason angular strives
to make both of these operations trivial. This example shows off how you can build a simple form to
allow a user to enter data.
+
+
<doc:example>
<doc:source>
<script>
@@ -23,14 +26,18 @@ allow a user to enter data.
</script>
<div ng:controller="FormController" class="example">
+
<label>Name:</label><br/>
<input type="text" name="user.name" ng:required/> <br/><br/>
+
<label>Address:</label><br/>
<input type="text" name="user.address.line1" size="33" ng:required/> <br/>
<input type="text" name="user.address.city" size="12" ng:required/>,
<input type="text" name="user.address.state" size="2" ng:required ng:validate="regexp:state"/>
- <input type="text" name="user.address.zip" size="5" ng:required ng:validate="regexp:zip"/><br/><br/>
+ <input type="text" name="user.address.zip" size="5" ng:required
+ng:validate="regexp:zip"/><br/><br/>
+
<label>Phone:</label>
[ <a href="" ng:click="user.contacts.$add()">add</a> ]
@@ -49,6 +56,7 @@ allow a user to enter data.
<pre>user={{user}}</pre>
</div>
+
</doc:source>
<doc:scenario>
it('should show debug', function(){
@@ -61,42 +69,53 @@ allow a user to enter data.
expect(binding('user')).toMatch(/you@example.org/);
});
+
it('should remove contact', function(){
using('.example').element('a:contains(X)').click();
expect(binding('user')).not().toMatch(/\(234\) 555\-1212/);
});
+
it('should validate zip', function(){
expect(using('.example').element(':input[name=user.address.zip]').attr('className'))
- .not().toMatch(/ng-validation-error/);
+ .not().toMatch(/ng-validation-error/)
+
using('.example').input('user.address.zip').enter('abc');
+
expect(using('.example').element(':input[name=user.address.zip]').attr('className'))
- .toMatch(/ng-validation-error/);
+ .toMatch(/ng-validation-error/)
});
+
it('should validate state', function(){
expect(using('.example').element(':input[name=user.address.state]').attr('className'))
- .not().toMatch(/ng-validation-error/);
+ .not().toMatch(/ng-validation-error/)
+
using('.example').input('user.address.state').enter('XXX');
+
expect(using('.example').element(':input[name=user.address.state]').attr('className'))
- .toMatch(/ng-validation-error/);
+ .toMatch(/ng-validation-error/)
});
</doc:scenario>
</doc:example>
+
+
# Things to notice
-* The user data model is initialized {@link angular.directive.@ng:controller controller} and is available in
- the {@link angular.scope scope} with the initial data.
+
+* The user data model is initialized {@link api/angular.directive.@ng:controller controller} and is
+available in
+ the {@link api/angular.scope scope} with the initial data.
* For debugging purposes we have included a debug view of the model to better understand what
is going on.
-* The {@link angular.widget.HTML input widgets} simply refer to the model and are auto bound.
-* The inputs {@link angular.validator validate}. (Try leaving them blank or entering non digits
+* The {@link api/angular.widget.HTML input widgets} simply refer to the model and are auto bound.
+* The inputs {@link api/angular.validator validate}. (Try leaving them blank or entering non digits
in the zip field)
* In your application you can simply read from or write to the model and the form will be updated.
* By clicking the 'add' link you are adding new items into the `user.contacts` array which are then