Skip to content

Commit 8d6eed2

Browse files
committed
docs(guide/templates): clarity
1 parent 7c34e1f commit 8d6eed2

1 file changed

Lines changed: 21 additions & 26 deletions

File tree

‎docs/content/guide/templates.ngdoc‎

Lines changed: 21 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,21 @@
22
@name Templates
33
@description
44

5-
An Angular template is the declarative specification that, along with information from the model
6-
and controller, becomes the rendered view that a user sees in the browser. It is the static DOM,
7-
containing HTML, CSS, and angular-specific elements and angular-specific element attributes. The
8-
Angular elements and attributes direct angular to add behavior and transform the template DOM into
9-
the dynamic view DOM.
5+
In Angular, templates are written with HTML that contains Angular-specific elements and attributes.
6+
Angular combines the template with information from the model and controller to render the dynamic
7+
view that a user sees in the browser.
108

11-
These are the types of Angular elements and element attributes you can use in a template:
9+
These are the types of Angular elements and attributes you can use:
1210

1311
* {@link guide/directive Directive} — An attribute or element that
14-
augments an existing DOM element or represents a reusable DOM component - a widget.
15-
* {@link ng.$interpolate Markup} — The double
16-
curly brace notation `{{ }}` to bind expressions to elements is built-in angular markup.
17-
* {@link guide/filter Filter} — Formats your data for display to the user.
18-
* {@link forms Form controls} — Lets you validate user input.
12+
augments an existing DOM element or represents a reusable DOM component.
13+
* {@link ng.$interpolate Markup} — The double curly brace notation `{{ }}` to bind expressions
14+
to elements is built-in Angular markup.
15+
* {@link guide/filter Filter} — Formats data for display.
16+
* {@link forms Form controls} — Validates user input.
1917

20-
Note: In addition to declaring the elements above in templates, you can also access these elements
21-
in JavaScript code.
22-
23-
The following code snippet shows a simple Angular template made up of standard HTML tags along with
24-
Angular {@link guide/directive directives} and curly-brace bindings
25-
with {@link expression expressions}:
18+
The following code snippet shows a template with {@link guide/directive directives} and
19+
curly-brace {@link expression expression} bindings:
2620

2721
```html
2822
<html ng-app>
@@ -38,19 +32,20 @@ with {@link expression expressions}:
3832
</html>
3933
```
4034

41-
In a simple single-page app, the template consists of HTML, CSS, and angular directives contained
42-
in just one HTML file (usually `index.html`). In a more complex app, you can display multiple views
43-
within one main page using "partials", which are segments of template located in separate HTML
44-
files. You "include" the partials in the main page using the {@link ngRoute.$route
45-
$route} service in conjunction with the {@link ngRoute.directive:ngView ngView} directive. An
46-
example of this technique is shown in the {@link tutorial/ angular tutorial}, in steps seven and
47-
eight.
35+
In a simple app, the template consists of HTML, CSS, and Angular directives contained
36+
in just one HTML file (usually `index.html`).
37+
38+
In a more complex app, you can display multiple views within one main page using "partials" –
39+
segments of template located in separate HTML files. You can use the
40+
{@link ngRoute.directive:ngView ngView} directive to load partials based on configuration passed
41+
to the {@link ngRoute.$route $route} service. The {@link tutorial/ angular tutorial} shows this
42+
technique in steps seven and eight.
4843

4944

5045
## Related Topics
5146

52-
* {@link guide/filter Angular Filters}
53-
* {@link forms Angular Forms}
47+
* {@link guide/filter Filters}
48+
* {@link forms Forms}
5449

5550
## Related API
5651

0 commit comments

Comments
 (0)