2016-11-23 12:58:21 -05:00
block includes
include _util-fns
- var _on_Plunkr = 'on Plunkr';
2016-03-13 15:50:50 -04:00
2015-12-10 21:29:14 -05:00
:marked
2016-11-28 16:31:06 -05:00
Angular applications are made up of _components_.
2016-11-22 20:44:34 -05:00
A _component_ is the combination of an HTML template and a component class that controls a portion of the screen. Here is an example of a component that displays a simple string:
2015-10-14 23:25:19 -04:00
2016-11-23 12:58:21 -05:00
+makeExample('app/app.component.ts')(format='.')
2016-11-22 20:44:34 -05:00
2015-12-10 21:29:14 -05:00
:marked
2016-11-23 12:58:21 -05:00
You can try this out without installing anything. Open the <live-example>QuickStart example !{_on_Plunkr}</live-example> in another tab
and follow along.
2016-05-14 20:40:52 -04:00
2016-11-23 12:58:21 -05:00
Every component begins with an `@Component` [!{_decorator}](glossary.html#!{_decorator} '"!{_decorator}" explained')
<span if-docs="ts">function</span> that
<span if-docs="ts">takes a _metadata_ object. The metadata object</span> describes how the HTML template and component class work together.
2016-11-28 16:31:06 -05:00
2016-11-21 20:13:21 -05:00
The `selector` property tells Angular to display the component inside a custom `<my-app>` tag in the `index.html`.
+makeExample('index.html','my-app','index.html (inside <body>)')(format='.')
2016-07-27 03:24:54 -04:00
:marked
2016-11-21 20:13:21 -05:00
The `template` property defines a message inside an `<h1>` header.
2016-11-28 16:31:06 -05:00
The message starts with "Hello" and ends with `{{name}}`,
2016-11-21 20:13:21 -05:00
which is an Angular [interpolation binding](guide/displaying-data.html) expression.
2016-11-28 16:31:06 -05:00
At runtime, Angular replaces `{{name}}` with the value of the component's `name` property.
2016-11-22 20:44:34 -05:00
In the example, change the component class's `name` property from `'Angular'` to `'World'` and see what happens.
2016-11-28 16:31:06 -05:00
2016-11-22 20:44:34 -05:00
Interpolation binding is one of many Angular features you'll discover in this documentation.
2016-02-12 20:54:22 -05:00
2016-11-23 12:58:21 -05:00
+ifDocsFor('ts')
.callout.is-helpful
header A word about TypeScript
p.
This example is written in <a href="http://www.typescriptlang.org/" target="_blank" title="TypeScript">TypeScript</a>, a superset of JavaScript. Angular
uses TypeScript because its types make it easy to support developer productivity with tooling. You can also write Angular code in JavaScript; <a href="cookbook/ts-to-js.html">this guide</a> explains how.
2016-11-18 16:23:38 -05:00
2016-11-22 20:44:34 -05:00
.l-sub-section
:marked
### Next step
To learn how to write a real application, your next step is to set up a local development
environment and begin exploring with code. The [**Developer Guide**](guide/index.html)
shows you how.
2016-08-09 12:38:25 -04:00
