2011-05-11 00:45:42 +00:00
|
|
|
|
@ngdoc overview
|
2011-05-02 17:16:50 +00:00
|
|
|
|
@name Tutorial: Step 2
|
|
|
|
|
|
@description
|
|
|
|
|
|
<table id="tutorial_nav">
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td id="previous_step">{@link tutorial.step_01 Previous}</td>
|
|
|
|
|
|
<td id="step_result">{@link http://angular.github.com/angular-phonecat/step-2/app Live
|
2011-05-11 00:45:42 +00:00
|
|
|
|
Demo}</td>
|
2011-05-02 17:16:50 +00:00
|
|
|
|
<td id="tut_home">{@link tutorial Tutorial Home}</td>
|
|
|
|
|
|
<td id="code_diff">{@link https://github.com/angular/angular-phonecat/compare/step-1...step-2 Code
|
|
|
|
|
|
Diff}</td>
|
|
|
|
|
|
<td id="next_step">{@link tutorial.step_03 Next}</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
</table>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
Now it's time to make this web page dynamic with angular. We'll also add a test that verifies the
|
2011-05-11 00:45:42 +00:00
|
|
|
|
code for the controller we are going to add.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
There are many ways to structure the code for an application. With angular, we encourage the use of
|
|
|
|
|
|
{@link http://en.wikipedia.org/wiki/Model–View–Controller the MVC design pattern} to decouple the
|
|
|
|
|
|
code and separate concerns. With that in mind, let's use a little angular and JavaScript to add
|
|
|
|
|
|
model, view, and controller components to our app.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Reset your workspace to step 2.
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
git checkout -f step-2
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
or
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
./goto_step.sh 2
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
2. Refresh your browser or check the app out on {@link
|
2011-05-11 00:45:42 +00:00
|
|
|
|
http://angular.github.com/angular-phonecat/step-2/app angular's server}.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The app now contains a list with 3 phones.
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
The most important changes are listed below. You can see the full diff on {@link
|
|
|
|
|
|
https://github.com/angular/angular-phonecat/compare/step-1...step-2 GitHub}:
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
## Template for the View
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
The __view__ component is constructed by angular from this template:
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
__`app/index.html`:__
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
...
|
|
|
|
|
|
<body ng:controller="PhoneListCtrl">
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
<ul>
|
|
|
|
|
|
<li ng:repeat="phone in phones">
|
|
|
|
|
|
{{phone.name}}
|
|
|
|
|
|
<p>{{phone.snippet}}</p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
<script src="lib/angular/angular.js" ng:autobind></script>
|
|
|
|
|
|
<script src="js/controllers.js"></script>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
We replaced the hard-coded phone list with the {@link angular.widget.@ng:repeat ng:repeat widget}
|
2011-05-11 00:45:42 +00:00
|
|
|
|
and two {@link guide.expression angular expressions} enclosed in curly braces: `{{phone.name}}` and
|
|
|
|
|
|
`{{phone.snippet}}`:
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
* The `ng:repeat="phone in phones"` statement in the `<li>` tag is an angular repeater. It
|
2011-05-11 00:45:42 +00:00
|
|
|
|
tells angular to create a `<li>` element for each phone in the phones list, using the first `<li>`
|
|
|
|
|
|
tag as the template.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<img src="img/tutorial/tutorial_02_final.png">
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
* The curly braces around `phone.name` and `phone.snippet` are an example of {@link
|
2011-05-11 00:45:42 +00:00
|
|
|
|
angular.markup angular markup}. The curly markup is shorthand for the angular directive {@link
|
|
|
|
|
|
angular.directive.ng:bind ng:bind}. The `ng:bind` directives indicate to angular that these are
|
|
|
|
|
|
template binding points. Binding points are locations in the template where angular creates
|
|
|
|
|
|
data-binding between the view and the model. In angular, the view is a projection of the model
|
|
|
|
|
|
through the HTML template. This means that whenever the model changes, angular refreshes the
|
|
|
|
|
|
appropriate binding points, which updates the view.
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Model and Controller
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
The data __model__ (a simple array of phones in object literal notation) is instantiated within
|
|
|
|
|
|
the __controller__ function (`PhoneListCtrl`):
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
__`app/js/controllers.js`:__
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
function PhoneListCtrl() {
|
|
|
|
|
|
this.phones = [{"name": "Nexus S",
|
|
|
|
|
|
"snippet": "Fast just got faster with Nexus S."},
|
|
|
|
|
|
{"name": "Motorola XOOM™ with Wi-Fi",
|
|
|
|
|
|
"snippet": "The Next, Next Generation tablet."},
|
|
|
|
|
|
{"name": "MOTOROLA XOOM™",
|
|
|
|
|
|
"snippet": "The Next, Next Generation tablet."}];
|
|
|
|
|
|
}
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
Although the controller is not yet doing very much controlling, it is playing a crucial role. By
|
|
|
|
|
|
providing context for our data model, the controller allows us to establish data-binding between
|
|
|
|
|
|
the model and the view. Note in the following how we connected the dots between our presentation,
|
2011-05-11 00:45:42 +00:00
|
|
|
|
data, and logic components:
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
* The name of our controller function (in the JavaScript file `controllers.js`) matches the
|
2011-05-11 00:45:42 +00:00
|
|
|
|
{@link angular.directive.ng:controller ng:controller} directive in the `<body>` tag
|
|
|
|
|
|
(`PhoneListCtrl`).
|
2011-05-02 17:16:50 +00:00
|
|
|
|
* We instantiated our data within the scope of our controller function, and our template
|
2011-05-11 00:45:42 +00:00
|
|
|
|
binding points are located within the block bounded by the `<body ng:controller="PhoneListCtrl">`
|
|
|
|
|
|
tag.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Angular scopes are a crucial concept in angular; you can think of scopes as the glue that makes
|
|
|
|
|
|
the template, model and controller all work together. Angular uses scopes, along with the
|
|
|
|
|
|
information contained in the template, data model, and controller, to keep the model and view
|
|
|
|
|
|
separated but in sync. Any changes to the model are reflected in the view; any changes that occur
|
|
|
|
|
|
in the view are reflected in the model. To learn more about angular scopes, see the {@link
|
|
|
|
|
|
angular.scopes angular scope documentation}.
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tests
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
The "Angular way" makes it easy for us to test as we develop; the unit test for your newly created
|
|
|
|
|
|
controller looks as follows:
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
__`test/unit/controllersSpec.js`:__
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
describe('PhoneCat controllers', function() {
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
describe('PhoneListCtrl', function(){
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
it('should create "phones" model with 3 phones', function() {
|
|
|
|
|
|
var ctrl = new PhoneListCtrl();
|
|
|
|
|
|
expect(ctrl.phones.length).toBe(3);
|
|
|
|
|
|
});
|
|
|
|
|
|
});
|
|
|
|
|
|
});
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
Ease of testing is another cornerstone of angular's design philosophy. All we are doing here is
|
|
|
|
|
|
showing how easy it is to create a unit test. The test verifies that we have 3 records in the
|
|
|
|
|
|
phones array.
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
Angular developers prefer the syntax of Jasmine's Behavior-driven Development (BDD) framework when
|
2011-05-02 17:16:50 +00:00
|
|
|
|
writing tests. Although Jasmine is not required by angular, we used it to write all tests in this
|
2011-05-11 00:45:42 +00:00
|
|
|
|
tutorial. You can learn about Jasmine on the {@link http://pivotal.github.com/jasmine/ Jasmine home
|
|
|
|
|
|
page} and on the {@link https://github.com/pivotal/jasmine/wiki Jasmine wiki}.
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
The angular-seed project is pre-configured to run all unit tests using {@link
|
2011-05-02 17:16:50 +00:00
|
|
|
|
http://code.google.com/p/js-test-driver/ JsTestDriver}. To run the test, do the following:
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
1. In a _separate_ terminal window or tab, go to the `angular-phonecat` directory and run
|
|
|
|
|
|
`./scripts/test-server.sh` to start the test web server.
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
2. Open a new browser tab or window and navigate to {@link http://localhost:9876}.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Choose "Capture this browser in strict mode".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
At this point, you can leave this tab open and forget about it. JsTestDriver will use it to execute
|
|
|
|
|
|
the tests and report the results in the terminal.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. Execute the test by running `./scripts/test.sh`
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
|
|
|
|
|
|
You should see the following or similar output:
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
Chrome: Runner reset.
|
|
|
|
|
|
.
|
|
|
|
|
|
Total 1 tests (Passed: 1; Fails: 0; Errors: 0) (2.00 ms)
|
|
|
|
|
|
Chrome 11.0.696.57 Mac OS: Run 1 tests (Passed: 1; Fails: 0; Errors 0) (2.00 ms)
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
Yay! The test passed! Or not...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Note: If you see errors after you run the test, close the browser tab and go back to the terminal
|
|
|
|
|
|
and kill the script, then repeat the procedure above.
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
|
|
|
|
|
|
# Experiments
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
* Add another binding to `index.html`. For example:
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
|
|
|
|
|
|
<p>Total number of phones: {{phones.length}}</p>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
* Create a new model property in the controller and bind to it from the template. For example:
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
this.hello = "Hello, World!"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Refresh your browser to make sure it says, "Hello, World!"
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
|
|
|
|
|
|
* Create a repeater that constructs a simple table:
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
<table>
|
|
|
|
|
|
<tr><th>row number</th></tr>
|
|
|
|
|
|
<tr ng:repeat="i in [0, 1, 2, 3, 4, 5, 6, 7]"><td>{{i}}</td></tr>
|
|
|
|
|
|
</table>
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
Now, make the list 1-based by incrementing `i` by one in the binding:
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
<table>
|
|
|
|
|
|
<tr><th>row number</th></tr>
|
|
|
|
|
|
<tr ng:repeat="i in [0, 1, 2, 3, 4, 5, 6, 7]"><td>{{i+1}}</td></tr>
|
|
|
|
|
|
</table>
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
* Make the unit test fail by changing the `toBe(3)` statement to `toBe(4)`, and rerun the
|
|
|
|
|
|
`./scripts/test.sh` script.
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
# Summary
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
2011-05-02 23:40:31 +00:00
|
|
|
|
You now have a dynamic app that features separate model, view, and controller components, and
|
|
|
|
|
|
you're testing as you go. Now, let's go to step 3 to learn how to add full text search to the app.
|
2011-05-02 17:16:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
2011-05-02 17:16:50 +00:00
|
|
|
|
<table id="tutorial_nav">
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td id="previous_step">{@link tutorial.step_01 Previous}</td>
|
|
|
|
|
|
<td id="step_result">{@link http://angular.github.com/angular-phonecat/step-2/app Live
|
2011-05-11 00:45:42 +00:00
|
|
|
|
Demo}</td>
|
2011-05-02 17:16:50 +00:00
|
|
|
|
<td id="tut_home">{@link tutorial Tutorial Home}</td>
|
|
|
|
|
|
<td id="code_diff">{@link https://github.com/angular/angular-phonecat/compare/step-1...step-2 Code
|
|
|
|
|
|
Diff}</td>
|
|
|
|
|
|
<td id="next_step">{@link tutorial.step_03 Next}</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
</table>
|
2011-05-11 00:45:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|