Начало работы
Настройка и bootstrap
AngularJS (1.x) подключается тегом script. ng-app запускает приложение, а ng-controller привязывает контроллер к поддереву DOM. Двойные фигурные скобки {{ }} — Angular-выражения, отображающие данные модели.
<!-- include AngularJS 1.8.x -->
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.8.2/angular.min.js"></script>
<body ng-app="myApp">
<div ng-controller="MainCtrl">
{{ message }}
</div>
</body>
<script>
var app = angular.module('myApp', []);
app.controller('MainCtrl', function($scope) {
$scope.message = 'Hello AngularJS!';
});
</script>ng-app и автозапуск
ng-app с именем модуля автоматически запускает AngularJS на DOMContentLoaded. ng-strict-di требует явных аннотаций зависимостей и помогает поймать ошибки минификации ещё в разработке. На странице автозапускается только один ng-app.
<!-- ng-app on <html> makes the whole page an Angular app -->
<html ng-app="myApp" ng-strict-di>
<head><title>App</title></head>
<body>
<div>{{ 1 + 2 }}</div>
</body>
</html>
<!-- ng-strict-di enforces dependency injection annotations -->
<!-- (errors if a service uses implicit DI without annotation) -->Ручной bootstrap
Используйте angular.bootstrap(), когда нужно отложить старт (например, дождаться асинхронной загрузки модулей или конфигурации). Так на одной странице можно запустить несколько Angular-приложений, каждое на своём корневом элементе.
<!-- HTML has NO ng-app attribute -->
<div id="appRoot">
{{ message }}
</div>
<script>
angular.element(document).ready(function() {
angular.bootstrap(document.getElementById('appRoot'), ['myApp']);
});
</script>Первая привязка данных
С ng-app без имени модуля Angular работает в режиме 'auto' с модулем ng по умолчанию. ng-model привязывает input к свойству 'name' неявного scope, а {{ }} отображает его в реальном времени. Это двусторонняя привязка данных в самом простом виде.
<div ng-app>
<label>Your name:
<input type="text" ng-model="name">
</label>
<p>Hello {{ name || 'stranger' }}!</p>
</div>Основы модулей и контроллеров
angular.module('name', [deps]) создаёт модуль; angular.module('name') получает существующий. Инлайн-аннотация массивом ['$scope', function($scope){}] защищает контроллер от минификации. Всегда явно передавайте зависимости модулю при создании.
var app = angular.module('myApp', []); // create module
// ^name ^dependencies
app.controller('GreetCtrl', ['$scope', function($scope) {
$scope.user = { name: 'Ada' };
$scope.greet = function() {
return 'Hi ' + $scope.user.name;
};
}]);Модули
Создание и получение модуля
Форма с двумя аргументами angular.module(name, deps) создаёт новый модуль. Форма с одним аргументом angular.module(name) получает ранее определённый. Случайно переданный второй раз [] молча стирает все регистрации модуля.
// CREATE a module (second arg = dependency array)
var app = angular.module('myApp', []);
// RETRIEVE an existing module (NO second arg)
// var app = angular.module('myApp');
// common mistake: passing [] again overwrites the moduleЗависимости модуля
Массив зависимостей перечисляет модули, чьи провайдеры внедряются в этот модуль. Встроенные модули вроде ngRoute необязательны — их нужно явно перечислить (и подключить их скрипт). Подмодули позволяют разбить большое приложение на переиспользуемые части.
var app = angular.module('myApp', [
'ngRoute', // built-in routing
'ngAnimate', // animation hooks
'ui.router', // 3rd-party router
'myApp.common', // your own sub-module
]);Блок config
config() выполняется во время регистрации провайдеров, до создания экземпляров сервисов. Единственное место, где можно внедрять и настр аивать провайдеры (например, $routeProvider, $locationProvider). Используйте его для настройки маршрутов, включения HTML5-режима или регистрации валидаторов.
app.config(['$routeProvider', function($routeProvider) {
$routeProvider
.when('/home', { templateUrl: 'home.html' })
.when('/about', { templateUrl: 'about.html' })
.otherwise({ redirectTo: '/home' });
}]);Блок run
run() выполняется после создания инжектора и конфигурации всех провайдеров — это «main» приложения. Внедряются экземпляры (не провайдеры). Обычно здесь регистрируют глобальные слушатели $rootScope для смены маршрута или проверки аутентификации.
app.run(['$rootScope', 'AuthService', function($rootScope, AuthService) {
$rootScope.$on('$routeChangeStart', function(event, next) {
if (!AuthService.isAuthenticated()) {
event.preventDefault();
}
});
}]);Constants и Values
constant() регистрирует значение, которое можно внедрять и в блоки config() — идеально для конфигурации, нужной провайдерам. value() доступен только конструкциям фазы run (сервисам, контроллерам). Используйте constant для конфигурации, которая нужна рано.
// constant: available in BOTH config and run phases
app.constant('API_BASE', 'https://api.example.com');
// value: available only in run phase (injectable as instance)
app.value('defaultPageSize', 20);
// usage in a service:
app.factory('UserSvc', ['API_BASE', function(API_BASE) {
return { all: function() { /* use API_BASE */ } };
}]);Контроллеры
Базовый контроллер
Контроллеры задают начальное состояние $scope и добавляют поведение (функции). Держите контроллеры тонкими — бизнес-логика живёт в сервисах. Конструктор контроллера выполняется при каждом создании нового экземпляра (например, при каждом использовании ng-controller).
app.controller('TodoCtrl', ['$scope', function($scope) {
$scope.todos = [
{ text: 'Learn AngularJS', done: true },
{ text: 'Build an app', done: false }
];
$scope.addTodo = function() {
$scope.todos.push({ text: $scope.todoText, done: false });
$scope.todoText = '';
};
$scope.remaining = function() {
return $scope.todos.filter(function(t) { return !t.done; }).length;
};
}]);Синтаксис Controller As
controllerAs публикует экземпляр контроллера в scope под псевдонимом (main). Используйте this вместо $scope для свойств и методов. Это избегает ловушек наследования $scope и делает явным, из какого контроллера приходит свойство во вложенных представлениях.
<div ng-controller="MainCtrl as main">
<p>{{ main.title }}</p>
<button ng-click="main.save()">Save</button>
</div>
<script>
app.controller('MainCtrl', function() {
this.title = 'Controller As';
this.save = function() { /* ... */ };
});
</script>DI, безопасный при минификации
Минификаторы переименовывают параметры функций, ломая вывод зависимостей по именам в Angular. Инлайн-аннотация массивом перечисляет имена сервисов строками перед функцией, поэтому имена переживают минификацию. Всегда используйте эту аннотацию или ng-annotate / $inject.
// SAFE: inline array annotation (parameter names are string literals)
app.controller('SafeCtrl', ['$scope', '$http', function($scope, $http) {
$http.get('/api/items').then(function(res) { $scope.items = res.data; });
}]);
// UNSAFE: implicit DI breaks when minified
app.controller('UnsafeCtrl', function($scope, $http) { /* ... */ });Аннотация через $inject
Альтернатива инлайн-массиву: прикрепите к конструктору массив $inject с именами сервисов. Объявление функции остаётся читаемым и переиспользуемым. Оба стиля эквивалентны — выберите один и придерживайтесь его (или автоматизируйте ng-annotate).
function UserCtrl($scope, UserService) {
UserService.list().then(function(users) {
$scope.users = users;
});
}
// explicit dependency list on the function
UserCtrl.$inject = ['$scope', 'UserService'];
app.controller('UserCtrl', UserCtrl);Вложенные контроллеры и наследование
Дочерние scope наследуются от родительских через прототип, поэтому дочерний контроллер читает свойства родителя. Но присваивание примитива в ребёнке создаёт новое локальное свойство, затеняющее родительское, а не обновляющее его — частая ловушка. Предпочитайте объекты (точечная нотация) или controllerAs.