You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Dec 4, 2017. It is now read-only.
Copy file name to clipboardExpand all lines: public/docs/ts/latest/glossary.jade
+44-50Lines changed: 44 additions & 50 deletions
Original file line number
Diff line number
Diff line change
@@ -33,15 +33,15 @@ block includes
33
33
:marked
34
34
You can compile Angular applications at build-time.
35
35
By compiling your application using the compiler-cli, `ngc`, you can bootstrap directly
36
-
to a Module Factory, meaning you don't need to include the Angular compiler in your Javascript bundle.
37
-
Ahead of Time compiled applications also benefit from decreased load time and increased performance.
36
+
to a module factory, meaning you don't need to include the Angular compiler in your JavaScript bundle.
37
+
Ahead of time compiled applications also benefit from decreased load time and increased performance.
38
38
39
39
:marked
40
40
## Angular Module
41
41
.l-sub-section
42
42
:marked
43
43
Helps you organize an application into cohesive blocks of functionality.
44
-
An Angular module identifies the components, directives, and pipes that the application uses along with the list of external Angular modules that the application needs, such as `FormsModule`.
44
+
An Angular module identifies the components, directives, and pipes that the application uses along with the list of external Angular modules that the application needs, such as `FormsModule`.
45
45
46
46
Every Angular application has an application root module class. By convention, the class is
47
47
called `AppModule` and resides in a file named `app.component.ts`.
@@ -60,11 +60,11 @@ block includes
60
60
## Attribute Directive
61
61
.l-sub-section
62
62
:marked
63
-
A category of [Directive](#directive) that can listen to and modify the behavior of
63
+
A category of [directive](#directive) that can listen to and modify the behavior of
64
64
other HTML elements, attributes, properties, and components. They are usually represented
65
65
as HTML attributes, hence the name.
66
66
67
-
A good example of an Attribute Directive is the `ngClass` directive for adding and removing CSS class names.
67
+
A good example of an attribute directive is the `ngClass` directive for adding and removing CSS class names.
68
68
69
69
.l-main-section#B
70
70
@@ -99,7 +99,7 @@ block includes
99
99
export * from './hero.service.ts'; // re-export all of its exports
100
100
export { HeroComponent } from './hero.component.ts'; // re-export the named thing
101
101
:marked
102
-
Now a consumer can import what they need from the barrel.
102
+
Now a consumer can import what it needs from the barrel.
103
103
code-example.
104
104
import { Hero, HeroService } from '../heroes'; // index is implied
105
105
:marked
@@ -120,7 +120,7 @@ block includes
120
120
Almost always refers to [Data Binding](#data-binding) and the act of
121
121
binding an HTML object property to a data object property.
122
122
123
-
May refer to a [Dependency Injection](#dependency-injection) binding
123
+
May refer to a [dependency injection](#dependency-injection) binding
124
124
between a "token", also referred to as a "key", and a dependency [provider](#provider).
125
125
This more rare usage should be clear in context.
126
126
@@ -129,9 +129,7 @@ block includes
129
129
.l-sub-section
130
130
blockbootstrap-defn-top
131
131
:marked
132
-
You launch an Angular application by "bootstrapping" it using the application root Angular module (`AppModule`).
133
-
Bootstrapping identifies an application's top level "root" [Component](#component), which is the first
134
-
component that is loaded for the application. For more information, see [QuickStart](!{docsLatest}/quickstart.html).
132
+
You launch an Angular application by "bootstrapping" it using the application root Angular module (`AppModule`). Bootstrapping identifies an application's top level "root" [component](#component), which is the first component that is loaded for the application. For more information, see [QuickStart](!{docsLatest}/quickstart.html).
135
133
:marked
136
134
You can bootstrap multiple apps in the same `index.html`, each with its own top level root.
137
135
@@ -141,7 +139,7 @@ block includes
141
139
.l-sub-section
142
140
:marked
143
141
The practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter
144
-
_except the first letter which is lowercase_.
142
+
_except the first letter, which is lowercase_.
145
143
146
144
Function, property, and method names are typically spelled in camelCase. Examples include: `square`, `firstName` and `getHeroes`. Notice that `square` is an example of how you write a single word in camelCase.
147
145
@@ -152,20 +150,18 @@ block includes
152
150
## Component
153
151
.l-sub-section
154
152
:marked
155
-
An Angular class responsible for exposing data
156
-
to a [View](#view) and handling most of the view’s display
157
-
and user-interaction logic.
153
+
An Angular class responsible for exposing data to a [View](#view) and handling most of the view’s display and user-interaction logic.
158
154
159
-
The *Component* is one of the most important building blocks in the Angular system.
160
-
It is, in fact, an Angular [Directive](#directive) with a companion [Template](#template).
155
+
The *component* is one of the most important building blocks in the Angular system.
156
+
It is, in fact, an Angular [directive](#directive) with a companion [template](#template).
161
157
162
158
You apply the `!{_at}Component` !{_decoratorLink} to
163
159
the component class, thereby attaching to the class the essential component metadata
164
160
that Angular needs to create a component instance and render it with its template
165
161
as a view.
166
162
167
163
Those familiar with "MVC" and "MVVM" patterns will recognize
168
-
the Component in the role of "Controller" or "View Model".
164
+
the component in the role of "controller" or "view model".
169
165
170
166
.l-main-section#D
171
167
:marked
@@ -194,17 +190,15 @@ block includes
194
190
Angular has a rich data binding framework with a variety of data binding
195
191
operations and supporting declaration syntax.
196
192
197
-
The many forms of binding include:
193
+
Read about the forms of binding in the [Template Syntax](!{docsLatest}/guide/template-syntax.html#data-binding) page:
A Decorator is a **function** that adds metadata to a class, its members (properties, methods) and function arguments.
211
+
A decorator is a **function** that adds metadata to a class, its members (properties, methods) and function arguments.
218
212
219
213
Decorators are a JavaScript language [feature](https://github.com/wycats/javascript-decorators), implemented in TypeScript and proposed for ES2016 (AKA ES7).
220
214
221
215
To apply a decorator, position it immediately above or to the left of the thing it decorates.
222
216
223
217
Angular has its own set of decorators to help it interoperate with your application parts.
224
218
Here is an example of a `@Component` decorator that identifies a
225
-
class as an Angular [Component](#component) and an `@Input` decorator applied to the `name` property
219
+
class as an Angular [component](#component) and an `@Input` decorator applied to the `name` property
226
220
of that component. The elided object argument to the `@Component` decorator would contain the pertinent component metadata.
227
221
```
228
222
@Component({...})
@@ -255,41 +249,41 @@ block includes
255
249
part "A" relies on another part "B", you say that "A" depends on "B" and
256
250
that "B" is a dependency of "A".
257
251
258
-
You can ask a "Dependency Injection System" to create "A"
252
+
You can ask a "dependency injection system" to create "A"
259
253
for us and handle all the dependencies.
260
254
If "A" needs "B" and "B" needs "C", the system resolves that chain of dependencies
261
255
and returns a fully prepared instance of "A".
262
256
263
257
Angular provides and relies upon its own sophisticated
264
-
[Dependency Injection](dependency-injection.html) system
258
+
[dependency injection](dependency-injection.html) system
265
259
to assemble and run applications by "injecting" application parts
266
260
into other application parts where and when needed.
267
261
268
-
At the core there is an [`Injector`](#injector) that returns dependency values on request.
262
+
At the core there is an [`injector`](#injector) that returns dependency values on request.
269
263
The expression `injector.get(token)` returns the value associated with the given token.
270
264
271
265
A token is an Angular type (`OpaqueToken`). You rarely deal with tokens directly; most
272
266
methods accept a class name (`Foo`) or a string ("foo") and Angular converts it
273
267
to a token. When you write `injector.get(Foo)`, the injector returns
274
268
the value associated with the token for the `Foo` class, typically an instance of `Foo` itself.
275
269
276
-
During many of its operations, Angular makes similar requests internally, such as when it creates a [`Component`](#component) for display.
270
+
During many of its operations, Angular makes similar requests internally, such as when it creates a [`component`](#component) for display.
277
271
278
272
The `Injector` maintains an internal map of tokens to dependency values.
279
273
If the `Injector` can't find a value for a given token, it creates
280
274
a new value using a `Provider` for that token.
281
275
282
-
A [Provider](#provider) is a recipe for
276
+
A [provider](#provider) is a recipe for
283
277
creating new instances of a dependency value associated with a particular token.
284
278
285
279
An injector can only create a value for a given token if it has
286
-
a `Provider` for that token in its internal provider registry.
280
+
a `provider` for that token in its internal provider registry.
287
281
Registering providers is a critical preparatory step.
288
282
289
283
Angular registers some of its own providers with every injector.
290
284
We can register our own providers.
291
285
292
-
Learn more in the [Dependency Injection](!{docsLatest}/guide/dependency-injection.html) page.
286
+
Read more in the [Dependency Injection](!{docsLatest}/guide/dependency-injection.html) page.
293
287
:marked
294
288
## Directive
295
289
.l-sub-section
@@ -315,11 +309,11 @@ block includes
315
309
They are the building blocks of an Angular application and the
316
310
developer can expect to write a lot of them.
317
311
318
-
1. [Attribute Directives](#attribute-directive) that can listen to and modify the behavior of
312
+
1. [Attribute directives](#attribute-directive) that can listen to and modify the behavior of
319
313
other HTML elements, attributes, properties, and components. They are usually represented
320
314
as HTML attributes, hence the name.
321
315
322
-
1. [Structural Directives](#structural-directive), a directive responsible for
316
+
1. [Structural directives](#structural-directive), a directive responsible for
323
317
shaping or reshaping HTML layout, typically by adding, removing, or manipulating
[property binding](!{docsLatest}/guide/template-syntax.html#property-binding) (explained in detail in the [Template Syntax](!{docsLatest}/guide/template-syntax.html) page).
381
375
Data values flow *into* this property from the data source identified
382
376
in the template expression to the right of the equal sign.
383
377
384
-
See the [Template Syntax](!{docsLatest}/guide/template-syntax.html#inputs-outputs) page.
378
+
See the [Input and output properties](!{docsLatest}/guide/template-syntax.html#inputs-outputs) section of the [Template Syntax](!{docsLatest}/guide/template-syntax.html) page.
385
379
386
380
:marked
387
381
## Interpolation
388
382
.l-sub-section
389
383
:marked
390
-
A form of [Property Data Binding](#data-binding) in which a
384
+
A form of [property data binding](#data-binding) in which a
391
385
[template expression](#template-expression) between double-curly braces
392
386
renders as text. That text may be concatenated with neighboring text
0 commit comments