|
2 | 2 | @name Getting Started
|
3 | 3 | @description
|
4 | 4 |
|
5 |
| -# Hello World! |
| 5 | +We want you to have an easy time while starting to use Angular. We've put together the following steps on your path to |
| 6 | +becoming an Angular expert. |
6 | 7 |
|
7 |
| -A great way for you to get started with AngularJS is to create the tradtional |
8 |
| -"Hello World!" app: |
| 8 | +1. Read the {@link guide/concepts conceptual overview}.<br/>Understand Angular's vocabulary and how all the Angular |
| 9 | + components work together. |
| 10 | +1. Do the {@link tutorial/ AngularJS Tutorial}.<br/>Walk end-to-end through building and application complete with tests |
| 11 | + on top of a node.js web server. Covers every major AngularJS feature and show you how to set up your development |
| 12 | + environment. |
| 13 | +1. Download or clone the {@link https://github.com/angular/angular-seed Seed App project template}.<br/>Gives you a |
| 14 | + starter app with a directory layout, test harness, and scripts to begin building your application. |
9 | 15 |
|
10 |
| -1. In your favorite text editor, create an HTML file |
11 |
| - (for example, `helloworld.html`). |
12 |
| -2. From the __Source__ box below, copy and paste the code into your HTML file. |
13 |
| - (Double-click on the source to easily select all.) |
14 |
| -3. Open the file in your web browser. |
15 | 16 |
|
16 |
| -<doc:example> |
17 |
| - <doc:source> |
18 |
| - Hello {{'World'}}! |
19 |
| - </doc:source> |
20 |
| -</doc:example> |
| 17 | +#Further Steps |
21 | 18 |
|
22 |
| -The resulting web page should look something like the following: |
| 19 | +##Watch Videos |
23 | 20 |
|
24 |
| -<img class="center" src="img/helloworld.png" border="1"> |
| 21 | +If you haven’t had a chance to watch the videos from the homepage, please check out: |
| 22 | +* {@link http://www.youtube.com/watch?v=WuiHuZq_cg4&list=PL173F1A311439C05D&context=C48ac877ADvjVQa1PpcFONnl4Q5x8hqvT6tRBTE-m0-Ym47jO3PEE%3D Introduction to AngularJS} |
| 23 | +* {@link http://www.youtube.com/watch?v=Yg-R1gchccg&list=PL173F1A311439C05D&context=C48ac877ADvjVQa1PpcFONnl4Q5x8hqvT6tRBTE-m0-Ym47jO3PEE%3D Creating Directives} |
| 24 | +* {@link http://www.youtube.com/watch?v=IRelx4-ISbs&list=PL173F1A311439C05D&context=C48ac877ADvjVQa1PpcFONnl4Q5x8hqvT6tRBTE-m0-Ym47jO3PEE%3D Communicating with Servers} |
25 | 25 |
|
26 |
| -Now let's take a closer look at that code, and see what is going on behind |
27 |
| -the scenes. |
| 26 | +And visit our {@link http://www.youtube.com/user/angularjs YouTube channel} for more AngularJS video presentations and |
| 27 | +tutorials. |
28 | 28 |
|
29 |
| -The `ng-app` tags tells angular to process the entire HTML page and bootstrap the app when the page |
30 |
| -is loaded: |
| 29 | +##Subscribe |
31 | 30 |
|
32 |
| -<pre> |
33 |
| - <html ng-app> |
34 |
| -</pre> |
| 31 | +* Subscribe to the {@link http://groups.google.com/forum/?fromgroups#!forum/angular mailing list}. Ask questions here! |
| 32 | +* Follow us on {@link https://twitter.com/intent/follow?original_referer=http%3A%2F%2Fangularjs.org%2F®ion=follow_link&screen_name=angularjs&source=followbutton&variant=2.0 Twitter} |
| 33 | +* Add us to your circles on {@link https://plus.google.com/110323587230527980117/posts Google+} |
35 | 34 |
|
36 |
| -The next line downloads the angular script: |
| 35 | +##Read more |
37 | 36 |
|
38 |
| -<pre> |
39 |
| - <script src="http://code.angularjs.org/angular-?.?.?.min.js"></script> |
40 |
| -</pre> |
41 |
| - |
42 |
| -(For details on what happens when angular processes an HTML page, |
43 |
| -see {@link guide/bootstrap Bootstrap}.) |
44 |
| - |
45 |
| -Finally, this line in the `<body>` of the page is the template that describes |
46 |
| -how to display our greeting in the UI: |
47 |
| - |
48 |
| -<pre> |
49 |
| - Hello {{'World'}}! |
50 |
| -</pre> |
51 |
| - |
52 |
| -Note the use of the double curly brace markup (`{{ }}`) to bind the expression to |
53 |
| -the greeting text. Here the expression is the string literal 'World'. |
54 |
| - |
55 |
| -Next let's look at a more interesting example, that uses AngularJS to |
56 |
| -bind a dynamic expression to our greeting text. |
57 |
| - |
58 |
| -# Hello AngularJS World! |
59 |
| - |
60 |
| -This example demonstrates angular's two-way data binding: |
61 |
| - |
62 |
| -1. Edit the HTML file you created in the "Hello World!" example above. |
63 |
| -2. Replace the contents of `<body>` with the code from the __Source__ box below. |
64 |
| -3. Refresh your browser window. |
65 |
| - |
66 |
| -<doc:example> |
67 |
| - <doc:source> |
68 |
| - Your name: <input type="text" ng-model="yourname" placeholder="World"> |
69 |
| - <hr> |
70 |
| - Hello {{yourname || 'World'}}! |
71 |
| - </doc:source> |
72 |
| -</doc:example> |
73 |
| - |
74 |
| -After the refresh, the page should look something like this: |
75 |
| - |
76 |
| -<img class="left" src="img/helloworld_2way.png" border="1" > |
77 |
| - |
78 |
| -These are some of the important points to note from this example: |
79 |
| - |
80 |
| -* The text input {@link guide/directive directive} |
81 |
| - is bound to a model variable called `yourname`. |
82 |
| -* The double curly braces notation binds the `yourname` model to the greeting text. |
83 |
| - |
84 |
| -* You did not need to explicitly register an event listener or define an event handler for events! |
85 |
| - |
86 |
| -Now try typing your name into the input box, and notice the immediate change to |
87 |
| -the displayed greeting. This demonstrates the concept of angular's |
88 |
| -{@link guide/dev_guide.templates.databinding bi-directional data binding}. Any changes to the input |
89 |
| -field are immediately |
90 |
| -reflected in the model (one direction), and any changes to the model are |
91 |
| -reflected in the greeting text (the other direction). |
92 |
| - |
93 |
| - |
94 |
| -# Anatomy Of An Angular App |
95 |
| - |
96 |
| -This section describes the 3 parts of an angular app, and explains how they map to the |
97 |
| -Model-View-Controller design pattern: |
98 |
| - |
99 |
| -## Templates |
100 |
| - |
101 |
| -Templates, which you write in HTML and CSS, serve as the View. You add elements, attributes, and |
102 |
| -markup to HTML, which serve as instructions to the angular compiler. The angular compiler is fully |
103 |
| -extensible, meaning that with angular you can build your own declarative language on top of HTML! |
104 |
| - |
105 |
| - |
106 |
| -## Application Logic and Behavior |
107 |
| - |
108 |
| -Application Logic and Behavior, which you define in JavaScript, serve as the Controller. With |
109 |
| -angular (unlike with standard AJAX applications) you don't need to write additional listeners or |
110 |
| -DOM manipulators, because they are built-in. This feature makes your application logic very easy to |
111 |
| -write, test, maintain, and understand. |
112 |
| - |
113 |
| - |
114 |
| -## Data |
115 |
| - |
116 |
| -The Model is referenced from properties on {@link guide/scope angular scope objects}. |
117 |
| -The data in your model could be Javascript objects, arrays, or primitives, it doesn't matter. What |
118 |
| -matters is that these are all referenced by the scope object. |
119 |
| - |
120 |
| -Angular employs scopes to keep your data model and your UI in sync. Whenever something occurs to |
121 |
| -change the state of the model, angular immediately reflects that change in the UI, and vice versa. |
122 |
| - |
123 |
| -The following illustration shows the parts of an angular application and how they work together: |
124 |
| - |
125 |
| -<img class="left" src="img/angular_parts.png" border="0" /> |
126 |
| - |
127 |
| -In addition, angular comes with a set of Services, which have the following properties: |
128 |
| - |
129 |
| -* The services provided are very useful for building web applications. |
130 |
| -* You can extend and add application-specific behavior to services. |
131 |
| -* Services include Dependency-Injection, XHR, caching, URL routing, and browser abstraction. |
132 |
| - |
133 |
| - |
134 |
| -# Where To Go Next |
135 |
| - |
136 |
| -* If you like what you've learned so far, you should definitely check out our awesome {@link |
137 |
| -tutorial/ Tutorial}, which walks you through the process of building real apps with AngularJS. |
138 |
| - |
139 |
| -* For further explanations and examples of the AngularJS concepts presented on this page, see the |
140 |
| -{@link guide/index Developer Guide}. |
141 |
| - |
142 |
| -* For additional hands-on examples of using AngularJS, including more source code that you can |
143 |
| -copy and paste into your own pages, take a look through the {@link cookbook/ Cookbook}. |
| 37 | +The AngularJS documentation includes the {@link guide/index Developer Guide} covering concepts and the |
| 38 | +{@link api/ API Reference} for syntax and usage. |
0 commit comments