AngularJS
Routing za pomocą ngRoute
Szukaj…
Uwagi
ngRoute
to wbudowany moduł zapewniający usługi routingu i głębokiego linkowania oraz wytyczne dla aplikacji kątowych.
Pełna dokumentacja dotycząca ngRoute
jest dostępna na https://docs.angularjs.org/api/ngRoute
Podstawowy przykład
Ten przykład pokazuje konfigurowanie małej aplikacji z 3 trasami, każda z własnym widokiem i kontrolerem, przy użyciu składni controllerAs
.
Konfigurujemy router przy użyciu kątowej funkcji .config
- Wprowadzamy
$routeProvider
do.config
- Nazwy naszych tras definiujemy za pomocą metody
.when
z obiektem definicji trasy. - Dostarczamy metodę
.when
obiektowi określającemu nasztemplate
lubtemplateUrl
,controller
icontrollerAs
app.js
angular.module('myApp', ['ngRoute'])
.controller('controllerOne', function() {
this.message = 'Hello world from Controller One!';
})
.controller('controllerTwo', function() {
this.message = 'Hello world from Controller Two!';
})
.controller('controllerThree', function() {
this.message = 'Hello world from Controller Three!';
})
.config(function($routeProvider) {
$routeProvider
.when('/one', {
templateUrl: 'view-one.html',
controller: 'controllerOne',
controllerAs: 'ctrlOne'
})
.when('/two', {
templateUrl: 'view-two.html',
controller: 'controllerTwo',
controllerAs: 'ctrlTwo'
})
.when('/three', {
templateUrl: 'view-three.html',
controller: 'controllerThree',
controllerAs: 'ctrlThree'
})
// redirect to here if no other routes match
.otherwise({
redirectTo: '/one'
});
});
Następnie w naszym HTML definiujemy naszą nawigację za pomocą elementów <a>
z href
, dla nazwy trasy helloRoute
będziemy kierować jako <a href="#/helloRoute">My route</a>
Zapewniamy również nasz widok pojemnikiem i dyrektywę ng-view
aby wstrzyknąć nasze trasy.
index.html
<div ng-app="myApp">
<nav>
<!-- links to switch routes -->
<a href="#/one">View One</a>
<a href="#/two">View Two</a>
<a href="#/three">View Three</a>
</nav>
<!-- views will be injected here -->
<div ng-view></div>
<!-- templates can live in normal html files -->
<script type="text/ng-template" id="view-one.html">
<h1>{{ctrlOne.message}}</h1>
</script>
<script type="text/ng-template" id="view-two.html">
<h1>{{ctrlTwo.message}}</h1>
</script>
<script type="text/ng-template" id="view-three.html">
<h1>{{ctrlThree.message}}</h1>
</script>
</div>
Przykład parametrów trasy
Ten przykład stanowi rozszerzenie podstawowego przykładu przekazywania parametrów na trasie w celu użycia ich w kontrolerze
W tym celu musimy:
- Skonfiguruj pozycję parametru i nazwę w nazwie trasy
- Wstrzyknij usługę
$routeParams
do naszego kontrolera
app.js
angular.module('myApp', ['ngRoute'])
.controller('controllerOne', function() {
this.message = 'Hello world from Controller One!';
})
.controller('controllerTwo', function() {
this.message = 'Hello world from Controller Two!';
})
.controller('controllerThree', ['$routeParams', function($routeParams) {
var routeParam = $routeParams.paramName
if ($routeParams.message) {
// If a param called 'message' exists, we show it's value as the message
this.message = $routeParams.message;
} else {
// If it doesn't exist, we show a default message
this.message = 'Hello world from Controller Three!';
}
}])
.config(function($routeProvider) {
$routeProvider
.when('/one', {
templateUrl: 'view-one.html',
controller: 'controllerOne',
controllerAs: 'ctrlOne'
})
.when('/two', {
templateUrl: 'view-two.html',
controller: 'controllerTwo',
controllerAs: 'ctrlTwo'
})
.when('/three', {
templateUrl: 'view-three.html',
controller: 'controllerThree',
controllerAs: 'ctrlThree'
})
.when('/three/:message', { // We will pass a param called 'message' with this route
templateUrl: 'view-three.html',
controller: 'controllerThree',
controllerAs: 'ctrlThree'
})
// redirect to here if no other routes match
.otherwise({
redirectTo: '/one'
});
});
Następnie, bez wprowadzania zmian w naszych szablonach, tylko dodając nowy link z niestandardową wiadomością, widzimy nową niestandardową wiadomość w naszym widoku.
index.html
<div ng-app="myApp">
<nav>
<!-- links to switch routes -->
<a href="#/one">View One</a>
<a href="#/two">View Two</a>
<a href="#/three">View Three</a>
<!-- New link with custom message -->
<a href="#/three/This-is-a-message">View Three with "This-is-a-message" custom message</a>
</nav>
<!-- views will be injected here -->
<div ng-view></div>
<!-- templates can live in normal html files -->
<script type="text/ng-template" id="view-one.html">
<h1>{{ctrlOne.message}}</h1>
</script>
<script type="text/ng-template" id="view-two.html">
<h1>{{ctrlTwo.message}}</h1>
</script>
<script type="text/ng-template" id="view-three.html">
<h1>{{ctrlThree.message}}</h1>
</script>
</div>
Definiowanie niestandardowego zachowania dla poszczególnych tras
Najprostszy sposób zdefiniowania niestandardowego zachowania dla poszczególnych tras byłby dość łatwy.
W tym przykładzie używamy go do uwierzytelnienia użytkownika:
1) routes.js
: utwórz nową właściwość (np. requireAuth
) dla dowolnej żądanej trasy
angular.module('yourApp').config(['$routeProvider', function($routeProvider) {
$routeProvider
.when('/home', {
templateUrl: 'templates/home.html',
requireAuth: true
})
.when('/login', {
templateUrl: 'templates/login.html',
})
.otherwise({
redirectTo: '/home'
});
}])
2) W kontroler najwyższego poziomu, który nie jest związany z elementem wewnątrz ng-view
(do konfliktu Unikać kątowe $routeProvider
), sprawdź, czy newUrl
ma requireAuth
właściwość i podjąć odpowiednie działania
angular.module('YourApp').controller('YourController', ['$scope', 'session', '$location',
function($scope, session, $location) {
$scope.$on('$routeChangeStart', function(angularEvent, newUrl) {
if (newUrl.requireAuth && !session.user) {
// User isn’t authenticated
$location.path("/login");
}
});
}
]);