diff options
| author | Misko Hevery | 2011-04-29 15:18:27 -0700 |
|---|---|---|
| committer | Igor Minar | 2011-06-06 22:28:38 -0700 |
| commit | 11e9572b952e49b01035e956c412d6095533031a (patch) | |
| tree | 04dbf96802f552693d44c541c0d825a2769e3d57 /docs/cookbook.form.ngdoc | |
| parent | b6bc6c2ddf1ae1523ec7e4cb92db209cd6501181 (diff) | |
| download | angular.js-11e9572b952e49b01035e956c412d6095533031a.tar.bz2 | |
Move documentation under individual headings
Diffstat (limited to 'docs/cookbook.form.ngdoc')
| -rw-r--r-- | docs/cookbook.form.ngdoc | 103 |
1 files changed, 0 insertions, 103 deletions
diff --git a/docs/cookbook.form.ngdoc b/docs/cookbook.form.ngdoc deleted file mode 100644 index c9fd9e9a..00000000 --- a/docs/cookbook.form.ngdoc +++ /dev/null @@ -1,103 +0,0 @@ -@workInProgress -@ngdoc overview -@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> - function FormController(){ - this.user = { - name: 'John Smith', - address:{line1: '123 Main St.', city:'Anytown', state:'AA', zip:'12345'}, - contacts:[{type:'phone', value:'1(234) 555-1212'}] - }; - this.state = /^\w\w$/; - this.zip = /^\d\d\d\d\d$/; - } - </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/> - - <label>Phone:</label> - [ <a href="" ng:click="user.contacts.$add()">add</a> ] - <div ng:repeat="contact in user.contacts"> - <select name="contact.type"> - <option>email</option> - <option>phone</option> - <option>pager</option> - <option>IM</option> - </select> - <input type="text" name="contact.value" ng:required/> - [ <a href="" ng:click="user.contacts.$remove(contact)">X</a> ] - </div> - <hr/> - Debug View: - <pre>user={{user}}</pre> - </div> - - </doc:source> - <doc:scenario> - it('should show debug', function(){ - expect(binding('user')).toMatch(/John Smith/); - }); - it('should add contact', function(){ - using('.example').element('a:contains(add)').click(); - using('.example div:last').input('contact.value').enter('you@example.org'); - expect(binding('user')).toMatch(/\(234\) 555\-1212/); - 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/); - - using('.example').input('user.address.zip').enter('abc'); - - expect(using('.example').element(':input[name=user.address.zip]').attr('className')) - .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/); - - using('.example').input('user.address.state').enter('XXX'); - - expect(using('.example').element(':input[name=user.address.state]').attr('className')) - .toMatch(/ng-validation-error/); - }); - </doc:scenario> -</doc:example> - - -# Things to notice - -* The user data model is initialized {@link angular.ng:controller controller} and is available in - the {@link 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 - 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 - reflected in the view. |
