Angular

Angularとは #

用語 #

用語意味
moduleアプリを構成するコンポーネントを束ねたもの.
root moduleアプリが起動する時に呼びされる大元のモジュール.
Angularアプリには必ずある.
componentView(画面の一部)を制御する.
templatecomponentのUIをどのようにHTMLで表現するかを指定するもの.
.htmlのこと.
Decoratorsモジュールやクラスなどの要素に対してメタ情報を付与するもの
constructorTS, JSに付随するものでClassの初期化時に発動する
data bindingコンポーネントにおいてテンプレートとクラス内の要素を繋ぐ仕組み.
テンプレートとコンポーネントのコードを繋ぐ方法
template reference variable#testを使って, そのDOM要素をtest変数で参照できるようにする仕組み.

Decoratorsのパラメーター #

パラメーター名意味
imports現在のモジュールで利用する他のモジュール/コンポーネント
exports現在のモジュールで外部に公開するコンポーネントなど
declarationsモジュール配下のコンポーネント
bootstrap最初に起動すべき最上位のコンポーネント(=ルートコンポーネント)
templateUrl描画するhtml
template描画する内容
styleUrlsどのcssを使うか
styles直接cssの内容を記述する
selectorコンポーネントの適応先を表す(html, css, classなどとして指定できる)

インストール #

npm i -g @angular/cli @angular/core

バージョンアップ #

ng update @angular/cli @angular/core

DockerでAngular #

Dockerfileの中身

FROM node:10.16.0-alpine

RUN apk update \
  && npm install -g @angular/cli@8.0.6 \
  && rm -rf /tmp/* /var/cache/apk/* *.tar.gz ~/.npm \
  && npm cache clear --force \
  && yarn cache clean \
  && sed -i -e "s/bin\/ash/bin\/sh/" /etc/passwd

WORKDIR /app

docker-compose.ymlの中身

version: "3"
services:
  angular:
    image: solareenlo/angular-cli
    build: .
    command: ash -c "ng serve --host=0.0.0.0"
    volumes:
      - .:/app
    ports:
      - "4200:4200"

として, Dockerfileだけでコンテナを動かすときは,

# first-appを作成
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli ng new first-app
# first-appディレクトリに移動
cd first-app
# コンテナに入って作業する
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli sh
# コンポーネントを作成
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli ng generate component sample-component
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli ng g c sample-component
# コンテナを立ち上げる
docker run -d -w /app -v $(pwd):/app -p 4200:4200 solareenlo/angular-cli ng serve --host 0.0.0.0

で, localhost:4200を開く.

Dockerfiledocker-compose.ymlでコンテナを動かすときは,

# first-appを作成
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli ng new first-app
# first-appディレクトリに移動
cd first-app
# コンテナに入って作業する
docker run -it --rm -w /app -v $(pwd):/app solareenlo/angular-cli sh
# docker-compose を使ってコンテナを立ち上げる
docker-compose up -d
# コンテナの中に入って作業する
docker-compose exec angular sh
# コンポーネント作成
docker-compose exec angular ng generate component sample-component
docker-compose exec angular ng g c sample-component
# テストは作らずにコンポーネント作成
docker-compose exec angular ng g c sample-component --spec false
# コンポーネントの中にコンポーネントを作成
docker-compose exec angular ng g c sample-component/test --spec false
# マテリアルデザインをインストール
docker-compose exec angular ng add @angular/material
# 関連するコンテンを全て止める
docker-compose stop
# 関連するコンテナを全削除
docker-compose rm

で, localhost:4200を開く.

コード例: solareenlo/angular-cli

npmの脆弱性を指摘されたら #

Angularでtarの脆弱性(Arbitrary File Overwrite)を指摘されたので修正する

TravisCI経由でGitHub Pagesに公開 #

  1. 新規リポジトリを作成
  • GitHub APIトークンを生成
  • Travi CIの設定
  • APIトークンの設定
  • リポジトリをクローン
  • Angular CLIで新規アプリを作成
  • (単体テスト)karma.conf.jsの修正
  • (総合テスト)protractor.conf.jsの修正
  • .travis.ymlの追加
  • GitHub Pagesにアクセス

Reference: AngularアプリをTravis CIからGitHub Pagesへデプロイする

マテリアルデザイン #

  • Googleが提唱した新しいデザインの方向性.
  • 優れた古典と最新の技術と科学を組み合わせたもの.
  • Angular用にもデザインコンポーネントがある.
  • 公式HP: https://material.angular.io

インストール #

npm i --save @angular/material
# or
ng add @angular/material

バージョンアップ #

ng update @angular/material

簡単な使い方 #

app.module.tsに以下を追加し,

import { MatInputModule, MatCardModule, MatButtonModule } from '@angular/material';
@NgModule ({
  imports: [
    MatInputModule,
    MatCardModule,
    MatButtonModule
  ]
})

.htmlで, 以下の様に使用し,

<mat-car>
  <mat-form-field>
    <textarea matInput [(ngModel)]="enteredValue"></textarea>
  </mat-form-field>
  <button
    mat-raised-button
    color="primary"
    (click)="onAddPost()">
    Save Post
  </button>
</mat-card>

.cssに以下の様に書く.

mat-card{
  width: 80;
  margin: auto;
}
mat-form-field,
textarea {
  width: 100%;
}

ファイル選択ボタンをMaterial化 #

/* .cssファイル */
.file-select-button, .file-name {
  display: inline-block;
  margin: 8px;
  }
<!-- .htmlファイル -->
<div class="container">
  <input type="file" style="display: none" #fileInput accept="image/*" (change)="onChangeFileInput()" />
  <button mat-raised-button color="primary" class="file-select-button" (click)="onClickFileInputButton()">
    <mat-icon>attach_file</mat-icon>
    ファイルを選択
  </button>

  <p class="file-name" *ngIf="!file; else fileName">ファイルが選択されていません</p>
  <ng-template #fileName>
    <p class="file-name">{{ file?.name }}</p>
  </ng-template>
</div>
// .tsファイル
import { Component, ViewChild } from '@angular/core';

@Component({
  selector: 'my-app',
  templateUrl: './app.component.html',
  styleUrls: [ './app.component.css' ]
})
export class AppComponent  {
  @ViewChild('fileInput')
  fileInput;

  file: File | null = null;

  onClickFileInputButton(): void {
    this.fileInput.nativeElement.click();
  }

  onChangeFileInput(): void {
    const files: { [key: string]: File } = this.fileInput.nativeElement.files;
    this.file = files[0];
  }
}
// app.module.tsファイル
import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { FormsModule } from '@angular/forms';
import { MatButtonModule, MatIconModule } from '@angular/material';

import { AppComponent } from './app.component';
import { HelloComponent } from './hello.component';

@NgModule({
  imports:      [ BrowserModule, FormsModule, MatButtonModule, MatIconModule ],
  declarations: [ AppComponent, HelloComponent ],
  bootstrap:    [ AppComponent ]
})
export class AppModule { }

Reference: Angular Materialでファイル選択ボタン

基本的な使い方 #

  • コンポーネント単位で作っていく.

  • 以下の様な感じでxxx.component.tsにコンポーネントの名前をselector: 'app-servers'で指定して, xxx.component.htmlの中で<app-server></app-server>と書いてどんどん使っていく.

    @Component({
    selector: 'app-servers',
    templateUrl: './servers.component.html',
    // template: '<app-server></app-server>',
    styleUrls: ['./servers.component.css']
    })
    
  • 必要なコンポーネント・モジュールができたらapp.module.tsに追加していく.

  • xxx.component.htmlにhtmlを, xxx.component.csにcssを, xxx.component.tsにjsをどんどん書いてく.

値を渡す(データバインド) #

  • []は, TypeScriptからHTMLへのバインドを表す.
  • ()は, HTMLからTypeScriptへのバインドを表す.
  • [()]は, 双方向のバインドを表す.

.tsから.htmlへ値を渡す #

// .tx側
export class TestComponent implements OnInit {
  newPost = 'Yes';
  constructor() {}
  ngOnInit() {}
}
<!-- .thml側 -->
<h1>{{ newPost }}</h1>

.tsから.html<>の中に値を渡す #

// .ts側
export class TestComponent implements OnInit {
  newPost = 'Yes';
  constructor() {}
  ngOnInit() {}
}
<!-- .thml側 -->
<textarea [value]="newPost"></textarea>

ユーザーからのinputを受け付ける. #

1文字ずつ受け付けるのは2種類ある.
xxx.component.htmlに以下の様に書く.

<!-- eventのbindを使う方法 -->
<input
  type="text"
  class="form-control"
  (input)="onUpdateServerName($event)">
<p>{{ serverName }}</p> <!-- serverNameが表示される -->

<!--
ngModelモジュールを使う方法
これを使う場合はapp.module.tsに
---
import { FormsModule } from '@angular/forms';
@NgModule({
  imports: [
    FormsModule
  ]
})
---
を追加する必要がある.
-->
<input
 type="text"
 class="form-control"
 [(ngModel)]="serverName">
<p>{{ serverName }}</p> <!-- serverNameが表示される -->

ボタンを押して受け付けるのは1つある.

<!-- .html側 -->
<textarea #postInput></textarea>
<button (click)="onAddPost(postInput)></button>
<p>{{ newPost }}</p>
// .ts側
export class TestComponent implements OnInit {
  newPost = '';
  constructor() {}
  ngOninit() {}
  onAddPost(postInput: HTMLTextAreaElement) {
    this.newPost = postInput;
  }
}

入力された値をコンポーネント内で操作する #

*.html内において,

<!-- ↓は親にそのまま入力した値がnewServerNameとして渡る -->
<input type="text" class="form-control" [(ngModel)]="newServerName">
<!-- ↓は子に入力された値が#serverNameInputとして残ってる -->
<input type="text" class="form-control" #serverNameInput>

子A > 親 > 子Bと渡す #

  • 子A > 親 が@output()で, データを渡す
  • 親 > 子B が@input()で, データを渡す
// 子Aの.tsの中身
import { Component, EventEmitter, Output } from '@angular/core';
@Component({
  selector: 'app-achild'
})
export class AchildComponent {
  @Output() postCreated = new EventEmitter();
  onAddPost() {
    const post = 'test';
    this.postCreated.emit(post);
  }
}
<!-- 親の.htmlの中身 -->
<!-- ここ↓は@Outoutなので, 子の要素postCreatedから親の要素onPostAddedに情報が行く -->
<app-achild (postCreated)="onPostAdded($event)"></app-achild>
<!-- ここ↓は@Input()なので, 子の要素postsに親の要素storedPostsから情報が行く -->
<app-bchild [posts]="storedPosts"></app-bchild>
// 親の.tsの中身の一部
export class AppComponent {
  storedPosts = [];
  onPostAdded(post) {
    this.storedPosts.push(post);
  }
}
// 子Aの.tsの中身
import { Component, Input } from '@angular/core';
@Component({
  selector: 'app-bchild'
})
export class AchildComponent {
  @Input() posts = [];
}

EventEmitter #

  • コンポーネントからその上位コンポーネントへの, 任意の値の通知を提供する.

下位コンポーネントの.tsに以下の様にして使う.

import { EventEmitter, Output } from '@angular/core';
export class TestComponent {
  @output() postCreated = new EventEmitter();
  onAddPost() {
    const post = test;
    this.postCreated.emit(post);
  }
}

コンポーネント間で値を渡す #

  • ここではxxx.service.tsを使う.
  • その際にはInjectableコンポーネントを使用する.
  • xxx.service.tsで, 渡すclassを作って, それを2つのコンポーネントのconstructorでそれぞれ作って, 渡される方の子コンポーネントのngOnInitで値を渡してあげる.
  • RxJSライブラリを使って, streamで非同期でコンポーネント間でデータを渡せる.
// xxx.service.tsの例
import { Injectable } from '@angular/core';
import { Post } from './post.model';
@Injectable({providedIn: 'root'})
export class PostsService {
  private posts: Post[] = [];
  getPosts() {
    return [...this.posts];
  }
  addPosts(title: string, content: string) {
    const post: Post = {title, content};
    this.posts.push(post);
  }
}
  1. componentでデータを変更する.
  • componentは変更したデータをメソッドコールによってserviceに渡す.
  • serviceは変更されたデータを受け取り, そのデータをイベント発火することで展開する.
  • componentは発火されたイベントをsubscribeし, 自身のプロパティを更新する.
// csv.service.tsの中身
import { Injectable } from '@angular/core';
// イベント発火のためのSubjectをimport
import { Subject } from 'rxjs';

@Injectable({providedIn: 'root'})

export class CsvService {
  // データの変更を通知するためのオブジェクト
  // 以降の「Subscribeのためのプロパティを宣言」と「データの更新イベント」で使用するプロパティを宣言し,  Subjectのインスタンスを生成する.
  // このプロパティを用いて共有データの変更通知を行う.
  private inputCsv  = new Subject<File>();
  // Subscribeするためのプロパティ(componetn間で共有するためのプロパティ)
  // 先に生成したオブジェクトinputCsvからasObservable()でオブジェクトを生成する.
  // asObservable()で生成されたオブジェクトは, データ共有を行うコンポーネント側でsubscribe(後述)することでデータ共有の仕組みを実現する.
  public inputCsv$ = this.inputCsv.asObservable();
  // CsvServiceのインスタンスを生成
  constructor() {}
  // データの更新イベント
  // これは先に生成したオブジェクトinputCsvからnext()を実行する.
  // このメソッドはデータ共有を行うコンポーネントから実行されることを想定したもので, 引数のinputをそのままnext()の引数にセットしている.
  // このメソッドでthis.inputCsv.next(input);が実行されることで, subscribe(後述)で待ち受けているコンポーネントに引数のデータが展開される.
  public onNotifyInputCsv(input: File) {
    this.inputCsv.next(input);
  }
}
// 送り手の.tsの中身
import { Component, OnInit, ViewChild } from '@angular/core';
import { CsvService } from '../service/csv.service';

@Component({
  selector: 'app-csv-input',
  templateUrl: './csv-input.component.html',
  styleUrls: ['./csv-input.component.css']
})
export class CsvInputComponent implements OnInit {
  @ViewChild('fileInput')
  fileInput;
  file: File | null = null;
  onClickFileInputButton(): void {
    this.fileInput.nativeElement.click();
  }
  onChangeFileInput(): void {
    const files: { [key: string]: File } = this.fileInput.nativeElement.files;
    this.file = files[0];
    // ここでデータをservice.tsへ送ってる.
    // ここで引数にセットしたデータがコンポーネント間で共有するデータとして扱われる.
    this.csvService.onNotifyInputCsv(this.file);
  }
  constructor(private csvService: CsvService) { }
  ngOnInit() {
  }
}
// 受け手の.tsの中身
import { Component, OnInit, OnDestroy } from '@angular/core';
import { Subscription } from 'rxjs';

import { CsvService } from '../service/csv.service';

@Component({
  selector: 'app-calculate',
  templateUrl: './calculate.component.html',
  styleUrls: ['./calculate.component.css']
})
export class CalculateComponent implements OnInit, OnDestroy {
  public file: File | null = null;
  // subscribeを保持するためのSubscription
  private csvSubscription: Subscription;
  constructor(private csvService: CsvService) {}
  ngOnInit() {
    // serviceで共有しているデータが更新されたら発火されるイベントをキャッチする.
    // inputCsv におけるデータの更新イベントでnext()によって発火されたイベントをsubscribeするイベントハンドラを登録している.
    // またcsvSubscriptionにsubscribeのオブジェクトをセットしているのは, 後述のngOnDestroyでsubscribeの内容を破棄するため.
    this.csvSubscription = this.csvService.inputCsv$.subscribe(csv => {
      this.file = csv;
    });
  }
  // component破棄時の後処理
  // subscribeした内容をcomponentが破棄されるタイミングでunsubscribeすることで破棄する.
  // これを行わないと, 登録したイベントハンドラが延々と生き続けることになる.
  ngOnDestroy() {
    this.csvSubscription.unsubscribe();
  }
}

Reference: Angular サービスを使用してデータをコンポーネント間で共有する

値を渡す(テンプレート参照変数) #

<input #test type="text" (key)="onKey(test.value)">

これで, inputにテキストで入力された文字が1つずつonKey関数に渡っていく.

ngIf else #

特定の状況下でのみアプリケーションがビューまたはビューの一部を表示する様にする.

<!--  *.htmlの中身 -->
<p *ngIf="serverCreated">Server was created, server name is {{ serverName }}</p>
// *.tsの中身
import { Component, OnInit } from '@angular/core';

@Component({
  selector: 'app-servers',
  templateUrl: './servers.component.html',
  styleUrls: ['./servers.component.css']
})
export class ServersComponent implements OnInit {
  serverCreated = false;
  constructor() {}
  ngOnInit() {
  }
  onCreateServer() {
    this.serverCreated = true;
    this.serverCreationStatus = 'Server was created!';
  }
}

ngStyle #

コンポーネントのスタイルを操作する.

<!--  *.htmlの中身
Hello World!が緑になったり赤になったりする.-->
<p [ngStyle]="{backgroundColor: getColor()}">Hello World!</p>
// *.tsの中身
import { Component } from '@angular/core';
@Component({
  selector: 'app-server',
  templateUrl: './server.component.html'
})
export class ServerComponent {
  serverStatus = 'offline';
  constructor() {
    this.serverStatus = Math.random() > 0.5 ? 'online' : 'offline';
  }
  getServerStatus() {
    return this.serverStatus;
  }
  getColor() {
    return this.serverStatus === 'online' ? 'green' : 'red';
  }
}

ngClass #

コンポーネントのクラスを扱う.

<!--  *.htmlの中身
Hello World!の背景が緑になったり赤になったりする.
背景が緑の時に文字が白色になる.
-->
<p
  [ngStyle]="{backgroundColor: getColor()}"
  [ngClass]="{online: serverStatus === 'online'}">
  Hello World!
</p>
// *.tsの中身
import { Component } from '@angular/core';
@Component({
  selector: 'app-server',
  templateUrl: './server.component.html',
  styles: [`.online { color: white; }`]
})
export class ServerComponent {
  serverStatus = 'offline';
  constructor() {
    this.serverStatus = Math.random() > 0.5 ? 'online' : 'offline';
  }
  getServerStatus() {
    return this.serverStatus;
  }
  getColor() {
    return this.serverStatus === 'online' ? 'green' : 'red';
  }
}

要素を渡す #

Aコンポーネントが利用させるときに, Aコンポーネントのタグに挟まっている要素をAコンポーネントが取得してきて, Aコンポーネント内の<ng-content></ng-content>の部分に展開する.

コンポーネントのライフサイクル #

フック目的とタイミング
ngOnChanges()
  • Angularがデータバインドされた入力プロパティを(再)設定するときに応答する.
  • このメソッドは, 現在および以前のプロパティ値のSimpleChangesオブジェクトを受け取る.
  • ngOnInit()の前に呼び出され, データバインドされた入力プロパティが変更されるたびに呼び出される.
  • ngOnInit()
  • Angularがデータバインドされたプロパティを最初に表示し, ディレクティブ/コンポーネントの入力プロパティを設定した後で, ディレクティブ/コンポーネントを初期化する.
  • 最初のngOnChanges()の後に一度呼び出される.
  • ngDoCheck()
  • Angularが検出できない, または検出できない変更を検出して, それに基づいて実行する.
  • 変更検知の実行中に毎回, そしてngOnChanges()とngOnInit()の直後に呼び出される.
  • ngAfterContentInit()
  • Angularがコンポーネントのビューあるいはディレクティブが存在するビューに, 外部コンテンツを投影した後に応答する.
  • 最初のngDoCheck()の後に1度呼び出される.
  • ngAfterContentChecked()
  • Angularがディレクティブ/コンポーネントに投影された外部コンテンツをチェックした後に応答する.
  • ngAfterContentInit()とその後全てのngDoCheck()の後に呼び出される.
  • ngAfterViewInit()
  • Angularがコンポーネントのビューと子のビュー, あるいはディレクティブが存在するビューを初期化した後に応答する.
  • 最初のngAfterContentChecked()の後に1度呼び出される.
  • ngAfterViewChecked()
  • Angularがコンポーネントのビューと子のビュー, あるいはディレクティブが存在するビューをチェックした後に応答する.
  • ngAfterViewInit()とその後のすべてのngAfterContentChecked()の後に呼び出される.
  • ngOnDestroy()
  • Angularがディレクティブ/コンポーネントを破棄する直前に, クリーンアップする.
  • メモリリークを回避するためにObservableの購読を解除し, イベントハンドラをデタッチしましょう.
  • Angularがディレクティブ/コンポーネントを破棄する直前に呼び出される.
  • Reference: ライフサイクル・フック

    formを使う #

    NgFormモジュールを使えば良い.

    // .tsの例
    import { NgForm } from `@angular/forms`;
    export class TestComponent {
      onAddPost(form: NgForm) {
        if (form.invalid) {
          return ;
        }
        const post = {
          title: form.value.title;
        }
      }
    }
    
    <!-- .htmlの例 -->
    <form (submit)="onAddPost(postForm)" #postForm="ngForm">
      <mat-form-field>
        <input
          matInput
          type="text"
          name="title"
          ngModel
          required
          #title="ngModel">
        <mat-error *ngIf="title.invalid">タイトルを入力してください.</mat-error>
      </mat-form-field>
    </form>
    

    デプロイ #