diff options
| author | Igor Minar | 2011-06-06 08:50:35 -0700 | 
|---|---|---|
| committer | Igor Minar | 2011-06-06 22:52:02 -0700 | 
| commit | 7f1e2e48467f80cc083d24b44f088620e4e7bcb6 (patch) | |
| tree | 731a91366c5780985be6d4c5ddbe34e307d5cb70 /docs/content/cookbook/form.ngdoc | |
| parent | 5533e48dead5cff3107e72ee80bf0f19df77c1e9 (diff) | |
| download | angular.js-7f1e2e48467f80cc083d24b44f088620e4e7bcb6.tar.bz2 | |
new batch of docs
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 | 
