⚡ アーカイブガイド: モダン Angular (v17+) が利用可能です
このチュートリアルは、依存性注入と複数モジュールのブートストラップを伴うレガシーな AngularJS 1.x アーキテクチャを対象としています。Angular Signals、Standalone Components、および TypeScript を使用するモダンな Angular アプリケーションについては、以下を参照してください:
モダン Angular (v17+) 統合チュートリアル →
サードパーティコンポーネント(StrelitLayout など)内で AngularJS 1.x を実行する場合、次のような課題が生じます:
- 複数のモジュールを連携させること
- 実行時に特定の DOM 要素へモジュールを直接ブートストラップすること
- 外部の依存関係(コンテナ、状態)をモジュールへ注入すること
- モジュール間で通信すること
これらの課題を解決するため、ユーザー一覧とユーザー詳細パネルの 2 つのモジュールから構成されるユーザー管理アプリを構築します。
- 各モジュールは個別の Strelit Layout コンテナ内に配置されます
- リストでユーザーを選択すると、詳細パネルに詳細情報が表示されます(モジュール間通信)
- 両方のモジュールを個別のポップアウトウィンドウに分離しても、双方向通信が継続します
- 初期選択ユーザーは、StrelitLayout のコンポーネント状態(外部依存関係)として渡されます
成果物
対話型サンプル: Angular と StrelitLayout
CodePen 上で完全なレイアウト実装を確認、フォーク、テストできます:
ユーザーリストモジュール
angular
.module('userlist', [])
.controller('userlistController', function ($scope, $timeout, container, state) {
var selectedUser = {};
// デモ用ユーザーデータ
$scope.users = [
{ name: 'Jackson Turner', street: '217 Tawny End', img: 'men/1.jpg' },
{ name: 'Megan Perry', street: '77 Burning Ramp', img: 'women/1.jpg' },
{ name: 'Ryan Harris', street: '12 Hazy Apple Route', img: 'men/2.jpg' },
{ name: 'Jennifer Edwards', street: '33 Maple Drive', img: 'women/2.jpg' },
{ name: 'Noah Jenkins', street: '423 Indian Pond Cape', img: 'men/3.jpg' },
];
// 選択されたユーザーを変更
$scope.select = function (user) {
selectedUser.isSelected = false;
user.isSelected = true;
selectedUser = user;
container.extendState({ selectedUserIndex: $scope.users.indexOf(user) });
container.layoutManager.eventHub.emit('userSelected', user);
};
// コンポーネント設定に基づいて初期ユーザーを選択
$timeout(function () {
$scope.select($scope.users[state.selectedUserIndex]);
});
});
ユーザー詳細モジュール
angular
.module('userdetails', [])
.controller('userdetailsController', function ($scope, container, state) {
$scope.user = state.user || null;
container.layoutManager.eventHub.on('userSelected', function (user) {
$scope.user = user;
container.extendState({ user: user });
$scope.$apply();
});
});
モジュール間通信
モジュール間の通信は EventHub によって仲介されます。この EventHub は Strelit Layout の一部であり、myLayout.eventHub または container.layoutManager.eventHub としてアクセスできます。これは開いているすべてのポップアウトウィンドウ間でもシームレスに双方向に動作する EventEmitter です。
コンテナと状態の注入
componentName: 'angularModule',
componentState: {
module: 'userlist',
templateId: 'userlistTemplate',
selectedUserIndex: 2
}
コンポーネント実装:
var AngularModuleComponent = function (container, state) {
var html = $('#' + state.templateId).html(),
element = container.getElement();
element.html(html);
// コンテナと状態をモジュールに値として注入
angular.module(state.module).value('container', container).value('state', state);
// 指定要素で Angular をブートストラップ
angular.bootstrap(element[0], [state.module]);
};