Skip to content

Manual Angular 2

Jump to bottom
Erick Souza edited this page Sep 2, 2016 · 12 revisions

Manual: criando uma aplicação com Angular 2

  1. No terminal, execute os comandos para criar e navegar para dentro de um diretório:
mkdir exemplo-angular2
cd exemplo-angular2
  1. Inicialize o npm dentro do diretório criado:
npm init -y

O comando acima criará um arquivo chamado package.json no diretório raiz da aplicação, que conterá as informações do projeto.

  1. Edite o arquivo package.json e adicione o seguinte conteúdo nele:
{
  "name": "exemplo-angular2",
  "version": "1.0.0",
  "scripts": {
    "tsc": "tsc",
    "clean": "rm -r app/js/*",
    "tsc:w": "tsc -w",
    "lite": "lite-server",
    "start": "concurrent \"npm run tsc:w\" \"npm run lite\" "
  },
  "author": "Erick Souza",
  "license": "ISC",
  "dependencies": {
    "angular2": "2.0.0-beta.0",
    "bootstrap": "3.3.6",
    "es6-promise": "3.0.2",
    "es6-shim": "0.34.1",
    "jquery": "2.2.0",
    "reflect-metadata": "0.1.3",
    "rxjs": "5.0.0-beta.0",
    "systemjs": "0.19.6",
    "zone.js": "0.5.10"
  },
  "devDependencies": {
    "concurrently": "1.0.0",
    "lite-server": "1.3.1",
    "typescript": "1.7.5"
  }
}

Em ‘scripts’ temos os comandos que executaremos para compilar e inicializar nosso servidor local, e em ‘dependencies’ e ‘devDependencies’ temos informações das bibliotecas a serem incluídas e utilizadas no projeto.

Perceba que o comando start cria uma concorrência entre os comandos npm run tsc:w e npm run lite. Em particular, o parâmetro w (watch mode) habilita o modo de escuta do compilador, isto é, alterações nos arquivos do projeto serão automaticamente percebidas pelo servidor de aplicação.

  1. Baixe as bibliotecas:
npm install

Este comando irá instalar as dependências definidas no passo anterior, tais como angular2 e bootstrap

  1. Crie o arquivo de configuração do TypeScript e acrescende o seguinte conteúdo:
touch tsconfig.json

{
  "compilerOptions": {
    "target": "ES5",
    "module": "system",
    "moduleResolution": "node",
    "sourceMap": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "removeComments": false,
    "noImplicitAny": false,
    "outDir": "app/js"
  },
  "exclude": [
    "node_modules"
  ]
}

O arquivo acima define as configurações do projeto, como por exemplo "outDir": "app/js" que inclui todos os arquivos .js (JavaScript) e .map (mapeamento) gerados pela compilação do TypeScript dentro do diretório app/js. Do ponto de vista da organização do código, é útil separar tais arquivos dos arquivos .ts (TypeScript), pois apenas os arquivos .ts devem ser alterados.

  1. Monte um componente conforme os passos a seguir:

6.1) Crie o diretório 'app' dentro de 'exemplo-angular2'

mkdir app
cd app

6.2) Crie o arquivo app/app-component.ts e acrescende o seguinte conteúdo:

touch app-component.ts

import {Component} from 'angular2/core';
 
@Component({
    selector: 'meu-app',
    template: '<h1>Meu primeiro app com o Angular 2!!!</h1>'
})
export class AppComponent{}

Um componente é uma classe TypeScript que utiliza a anotação @Component contendo uma quantidade variável de atributos. Neste exemplo, temos dois:

  • selector: contém o nome da tag que pode ser referenciada dentro de uma página html para carregar a view associada ao component.
  • template: contém o conteúdo da view associada ao component.

Em particular, este componente não possui um comportamento associado, já que a classe está vazia.

  1. Crie o arquivo de inicialização app/boot.ts e acrescende o seguinte conteúdo:
touch boot.ts

import {bootstrap}    from 'angular2/platform/browser'
import {AppComponent} from './app-component'
 
bootstrap(AppComponent);

Este arquivo irá inicializar a aplicação e possíveis dependências que sejam necessárias utilizando o método bootstrap() (que não tem nada a ver com o framework Bootstrap para criação de layouts responsivos).

  1. Crie o arquivo index.html na raiz da aplicação e acrescende o seguinte conteúdo:
cd ..
touch index.html

<html>
 
  <head>
    <title>Angular 2 - Primeira Aplicação</title>
 
    <!-- 1. Carregam as bibliotecas da aplicação -->
    <script src="node_modules/angular2/bundles/angular2-polyfills.js"></script>
    <script src="node_modules/systemjs/dist/system.src.js"></script>
    <script src="node_modules/rxjs/bundles/Rx.js"></script>
    <script src="node_modules/angular2/bundles/angular2.dev.js"></script>
 
    <!-- 2. Configura o SystemJS, que é responsável por carregar os arquivos js assincronamente -->
    <script>
      System.config({
        packages: {        
          app: {
            format: 'register',
            defaultExtension: 'js'
          }
        }
      });
      System.import('app/js/boot').then(null, console.error.bind(console));
    </script>
 
  </head>
 
  <!-- 3. Exibe a aplicação -->
  <body>
    <meu-app>Carregando...</meu-app>
  </body>
  
</html>

Esta página será a primeira carregada na aplicação e possui três partes importantes:

  • Carregamento das bibliotecas necessárias à aplicação, como as do Algular2 e Bootstrap (que ainda não adicionamos).
  • Configuração do SistemJS, responsável pelo carregamento assíncrono dos arquivos. Repare que o arquivo boot.ts criado no passo anterior é carregado.
  • Exibição da aplicação, que utiliza a tag <meu-app> definida no atributo selector do AppComponent.
  1. Compile e execute a aplicação:
npm run tsc
npm start

O primeiro comando compila a aplicação, gerando os arquivos .js e .map, e o segundo a executa.

  1. Modifique o arquivo app-component.ts:
import {Component} from 'angular2/core';

@Component({
    selector: 'meu-app',
    templateUrl: 'app/view/pagina.html'
})
export class AppComponent{

    total:number = 0;

    incrementar():number {
        return this.total++;
    }
}

O código acima apresenta duas modificações:

  • A primeira substitui o atributo template por templateUrl, permitindo que a view seja inserida em um arquivo distinto do componente.
  • A segunda implementa o comportamento no componente através do método incrementar(), que modifica o valor do atributo total.
  1. Crie o arquivo app/view/pagina.html com o seguinte conteúdo:
<!doctype html>
<html lang="pt">
    <head>
           <title>Página</title> 
    </head>
    <body>
        <button (click)="incrementar()">Clicar</button>
        <label>Você clicou: {{total}} vezes</label>        
    </body>
</html>

A nova página adiciona um evento ao botão utilizando o elemento (click), que captura o clique e chama o método incrementar() do component.

Referências

Clone this wiki locally