AngularJS
Enrutamiento usando ngRoute
Buscar..
Observaciones
El ngRoute
es un módulo incorporado que proporciona directivas y servicios de enrutamiento y deeplinking para aplicaciones angulares.
La documentación completa sobre ngRoute
está disponible en https://docs.angularjs.org/api/ngRoute
Ejemplo basico
Este ejemplo muestra la configuración de una pequeña aplicación con 3 rutas, cada una con su propia vista y controlador, utilizando la sintaxis del controllerAs
.
Configuramos nuestro enrutador en la función angular .config
.
-
$routeProvider
en.config
- Definimos nuestros nombres de ruta en el método
.when
con un objeto de definición de ruta. - Suministramos al método
.when
con un objeto que especifica nuestratemplate
otemplateUrl
,controller
ycontrollerAs
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'
});
});
Luego, en nuestro HTML definimos nuestra navegación usando <a>
elementos con href
, para un nombre de ruta de helloRoute
lo haremos como <a href="#/helloRoute">My route</a>
También proporcionamos nuestra vista con un contenedor y la directiva ng-view
para inyectar nuestras rutas.
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>
Ejemplo de parámetros de ruta
Este ejemplo amplía el ejemplo básico pasando parámetros en la ruta para usarlos en el controlador
Para ello necesitamos:
- Configure la posición y el nombre del parámetro en el nombre de la ruta
- Inyecte el servicio
$routeParams
en nuestro controlador
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'
});
});
Luego, sin hacer ningún cambio en nuestras plantillas, solo agregando un nuevo enlace con un mensaje personalizado, podemos ver el nuevo mensaje personalizado en nuestra vista.
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>
Definición de comportamiento personalizado para rutas individuales.
La forma más sencilla de definir el comportamiento personalizado para rutas individuales sería bastante fácil.
En este ejemplo lo usamos para autenticar a un usuario:
1) routes.js
: crea una nueva propiedad (como requireAuth
) para cualquier ruta deseada
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) En un controlador de nivel superior que no está vinculado a un elemento dentro de la ng-view
(para evitar conflictos con $routeProvider
angular), verifique si newUrl
tiene la propiedad requireAuth
y actúe en consecuencia
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");
}
});
}
]);