angular-docs-cn/public/docs/ts/latest/quickstart.jade

block includes
  include _util-fns

:marked
  Angular applications are made up of _components_.
    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:

  Angular 应用是由*组件*组成的。
    *组件*由 HTML 模板和组件类组成，组件类控制视图。下面是一个显示简单字符串的组件:

+makeExample('src/app/app.component.ts')(format='.')

block qs-src-online-and-local
  .l-sub-section
    :marked
      Try this **<live-example>QuickStart example on Plunker</live-example>** without installing anything.
      Try it locally with the [***QuickStart seed***](guide/setup.html "Setup for local development with the QuickStart seed")
      and prepare for development of a real Angular application.

:marked
  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.

  每个组件都以`@Component`[装饰器](glossary.html#!{_decorator} '"!{_decorator}" explained')<span if-docs="ts">函数</span>开始，它<span if-docs="ts">接受一个_元数据_对象参数。该元素对象</span>描述了 HTML 模板和组件类是如何一起工作的。

  The `selector` property tells Angular to display the component inside a custom `<my-app>` tag in the `index.html`.

  `selector`属性为 Angular 指定了在`index.html`中的自定义`<my-app>`标签里显示该组件。

+makeExample('src/index.html','my-app','index.html (inside <body>)')(format='.')
:marked
  The `template` property defines a message inside an `<h1>` header.
  The message starts with "Hello" and ends with `{{name}}`,
  which is an Angular [interpolation binding](guide/displaying-data.html) expression.
  At runtime, Angular replaces `{{name}}` with the value of the component's `name` property.
  Interpolation binding is one of many Angular features you'll discover in this documentation.

  `template`属性定义了`<h1>`标题里的一条消息。
  该消息以 “Hello” 开始，以 Angular [插值绑定](guide/displaying-data.html)表达式`{{name}}`结束。
  在运行时，Angular 用组件的`name`属性值替换`{{name}}`。
  插值绑定是 Angular 的特征之一。你将在本文档中探索更多 Angular 的特征。

+ifDocsFor('ts')
  :marked
    In the example, change the component class's `name` property from `'Angular'` to `'World'` and see what happens.

  .callout.is-helpful
    header A word about TypeScript

    header 关于 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.

    p.
      本例是用 JavaScript 的一个超集 <a href="http://www.typescriptlang.org/" target="_blank" title="TypeScript">TypeScript</a> 编写的。
      Angular 使用 TypeScript 是因为它的类型可以帮助工具提高开发者效率。你也可以用 JavaScript 编写 Angular 代码，参见<a href="cookbook/ts-to-js.html">本指南</a>。

.l-sub-section
    :marked
        ### Next step

        ### 下一步

        Start [**learning Angular**](guide/learning-angular.html "Learning Angular").

        开始[**学习 Angular**](guide/learning-angular.html "学习 Angular").