angular.module
概要
angular.moduleは、Angularモジュールの作成、登録、取得をグローバル空間で行うためのものです。 全てのモジュール(コアモジュール、またはサードパーティ製を含む)は、このメカニズムを使用してアプリケーションに登録する必要があり、 そのようにして利用可能にすべきです。
2つ、またはそれ以上の引数を渡すと、新しいモジュールが作成されます。 もし、1つだけ引数を渡すと、既存のモジュール(最初の引数としてモジュールの名前を渡します)を取得します。
モジュール
モジュールは、サービス、ディレクティブ、フィルターと設定情報を集めたものです。 angular.moduleは、$injectorを構成するのに使用されます。
// 新しいモジュールを作成
var myModule = angular.module('myModule', []);
// 新しいサービスを登録
myModule.value('appName', 'MyCoolApp');
// 初期化ブロック内で、既存サービスの構成を行います。
myModule.config(['$locationProvider', function($locationProvider) {
// 既存プロバイダーの設定
$locationProvider.hashPrefix('!');
}]);
下記のようにして、インジェクター($injector)の作成とモジュールの読み込みを行うことが可能です。
var injector = angular.injector(['ng', 'MyModule'])
ただし大抵の場合、ngAppまたはangular.bootstrapが使用され、 このプロセスを行ってくれます。
使用方法
angular.module(name[, requires], configFn);
引数 | 説明 |
---|---|
name |
型: 作成、または取得するモジュール名を指定します。 |
requires(optional) |
型: この引数が指定されると、新しいモジュールが作成されることになります。 指定されない場合は、更に設定を行うためにモジュールを取得することになります。 |
configFn |
型: モジュールのための任意の構成関数を指定します。 Moduleのconfig()メソッドと同じことを行います。 |
戻り値 | 説明 |
型: angular.ModuleのAPIを使用した新しいモジュールが返ります。 |
© 2017 Google
Licensed under the Creative Commons Attribution License 3.0.
このページは、ページトップのリンク先のAngularJS公式ドキュメント内のページを翻訳した内容を基に構成されています。 下記の項目を確認し、必要に応じて公式のドキュメントをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- AngularJSの更新頻度が高いため、元のコンテンツと比べてドキュメントの情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報やより分かり易くするための追記を行っている事があります。