diff options
Diffstat (limited to 'docs/content/cookbook/form.ngdoc')
| -rw-r--r-- | docs/content/cookbook/form.ngdoc | 37 |
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 |
