Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Angular でのルートレベルのコード分割

ルートレベルのコード分割を使用して、アプリのパフォーマンスを向上させましょう。

Minko Gechev

この記事では、Angular アプリケーションでルートレベルのコード分割を設定する方法について説明します。これにより、JavaScript バンドルサイズを削減し、Time to Interactive を大幅に改善できます。

この記事のコードサンプルは GitHub で入手できます。eager ルーティングの例は、eager ブランチで確認できます。ルートレベルのコード分割の例は、lazy ブランチにあります。

コード分割が重要な理由

ウェブアプリケーションの複雑化に伴い、ユーザーに提供される JavaScript の量が大幅に増加しています。サイズの大きい JavaScript ファイルは、インタラクティビティを著しく低下させる可能性があるため、特にモバイルではコストのかかるリソースとなる可能性があります。

アプリケーションの機能を犠牲にすることなく JavaScript バンドルを縮小する最も効率的な方法は、積極的なコード分割を導入することです。

コード分割を使用すると、アプリケーションの JavaScript を、異なるルートや機能に関連付けられた複数のチャンクに分割できます。このアプローチでは、アプリケーションの初期読み込み時に必要な JavaScript のみをユーザーに送信するため、読み込み時間を短縮できます。

コード分割の手法

コード分割は、コンポーネントレベルとルートレベルの 2 つのレベルで行うことができます。

コンポーネントレベルのコード分割では、コンポーネントを独自の JavaScript チャンクに移動し、必要に応じて遅延読み込みします。
ルートレベルのコード分割では、各ルートの機能を個別のチャンクにカプセル化します。ユーザーがアプリケーションを操作すると、個々のルートに関連付けられたチャンクが取得され、必要なときに関連する機能が提供されます。

この投稿では、Angular でルートレベルの分割を設定する方法について説明します。

サンプルアプリケーション

Angular でルートレベルのコード分割を使用する方法を詳しく説明する前に、サンプルアプリを見てみましょう。

アプリのモジュールの実装を確認します。AppModule 内には、HomeComponent に関連付けられたデフォルトルートと、NyanComponent に関連付けられた nyan ルートの 2 つのルートが定義されています。

@NgModule({
  ...
  imports: [
    BrowserModule,
    RouterModule.forRoot([
      {
        path: '',
        component: HomeComponent,
        pathMatch: 'full'
      },
      {
        path: 'nyan',
        component: NyanComponent
      }
    ])
  ],
  ...
})
export class AppModule {}

ルートレベルのコード分割

コード分割を設定するには、nyan のイーガールートをリファクタリングする必要があります。

Angular CLI のバージョン 8.1.0 では、次のコマンドですべての処理を行うことができます。

ng g module nyan --module app --route nyan

これにより、以下が生成されます。 - NyanModule という新しいルーティングモジュール - NyanModule を動的に読み込む AppModule 内の nyan というルート - NyanModule 内のデフォルトルート - ユーザーがデフォルトルートにアクセスしたときにレンダリングされる NyanComponent というコンポーネント

これらの手順を手動で行い、Angular でのコード分割の実装について理解を深めましょう。

ユーザーが nyan ルートに移動すると、ルーターはルーターアウトレットに NyanComponent をレンダリングします。

Angular でルートレベルのコード分割を使用するには、ルート宣言の loadChildren プロパティを設定し、動的インポートと組み合わせます。

{
  path: 'nyan',
  loadChildren: () => import('./nyan/nyan.module').then(m => m.NyanModule)
}

eager ルートとの主な違いは次の 2 つです。

component ではなく loadChildren を設定します。ルートレベルのコード分割を使用する場合は、コンポーネントではなく、動的に読み込まれるモジュールを指す必要があります。
loadChildren で、Promise が解決されたら、NyanComponent を参照する代わりに NyanModule を返します。

上記のスニペットでは、ユーザーが nyan に移動すると、Angular が nyan ディレクトリから nyan.module を動的に読み込み、モジュールで宣言されたデフォルトルートに関連付けられたコンポーネントをレンダリングするように指定しています。

デフォルトルートをコンポーネントに関連付けるには、次の宣言を使用します。

import { NgModule } from '@angular/core';
import { NyanComponent } from './nyan.component';
import { RouterModule } from '@angular/router';

@NgModule({
  declarations: [NyanComponent],
  imports: [
    RouterModule.forChild([{
      path: '',
      pathMatch: 'full',
      component: NyanComponent
    }])
  ]
})
export class NyanModule {}

このコードは、ユーザーが https://example.com/nyan に移動したときに NyanComponent をレンダリングします。

Angular ルーターがローカル環境で nyan.module を遅延ダウンロードすることを確認するには:

「Ctrl+Shift+J」（Mac の場合は「Command+Option+J」）を押して DevTools を開きます。
[ネットワーク] タブをクリックします。
サンプルアプリで [NYAN] をクリックします。
nyan-nyan-module.js ファイルが [Network] タブに表示されます。

この例は GitHub で確認できます。

スピナーを表示する

現時点では、ユーザーが [NYAN] ボタンをクリックしても、アプリはバックグラウンドで JavaScript を読み込んでいることを示しません。スクリプトの読み込み中にユーザーにフィードバックを提供するには、スピナーを追加することをおすすめします。

そのためには、まず app.component.html の router-outlet 要素内にインジケーターのマークアップを追加します。

<router-outlet>
  <span class="loader" *ngIf="loading"></span>
</router-outlet>

次に、ルーティングイベントを処理する AppComponent クラスを追加します。このクラスは、RouteConfigLoadStart イベントを検出すると loading フラグを true に設定し、RouteConfigLoadEnd イベントを検出するとフラグを false に設定します。

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {
  loading: boolean;
  constructor(router: Router) {
    this.loading = false;
    router.events.subscribe(
      (event: RouterEvent): void => {
        if (event instanceof NavigationStart) {
          this.loading = true;
        } else if (event instanceof NavigationEnd) {
          this.loading = false;
        }
      }
    );
  }
}

以下の例では、スピナーの動作を確認できるように、500 ミリ秒の人工的なレイテンシを導入しています。

まとめ

ルートレベルのコード分割を適用することで、Angular アプリケーションのバンドルサイズを縮小できます。

Angular CLI の遅延読み込みモジュールジェネレーターを使用して、動的に読み込まれるルートを自動的にスキャフォールディングします。
ユーザーが遅延ルートに移動したときに、読み込みインジケーターを追加して、アクションが進行中であることを示します。