7.3 Parámetros

En este tema vamos a ver cómo incluir parámetros en las rutas. Antes de explicar en qué consiste, volvamos a ver cómo funciona gmail.

Página “Recibidos” . URL=https://mail.google.com/mail/u/0/#inbox/147aa0e5820

Estamos en la página de recibidos pero estamos viendo un correo concreto. Para indicar qué correo queremos ver se pone en la propia URL de la ruta. En el ejemplo de gmail vemos que se quiere ver el correo “147aa0e5820”.

El valor del correo a mostrar lo indicaremos como parámetro en la ruta ya que no es un valor fijo sino que queremos que nos pasen el valor del parámetro en variable para poder usar ese valor.

Para poder definir un parámetro en la URL es tan sencillo como incluir el nombre de la variable en el path de la ruta precedido por ”:”. Veamos un ejemplo:

  $routeProvider.when('/pagina1/:variable1', {
    templateUrl: "pagina1.html",
    controller: "Pagina1Controller"
  });

• Línea 1: Ahora en el path hemos añadido una variable llamada variable1.

Ahora, vamos a poner ejemplos de posibles paths que casarían con la ruta que acabamos de definir y el valor de la variable variable1.

Pero NO podrá tener la siguientes formas:

• /pagina1
• /pagina1/
• /pagina1/pepe/3
• /pagina1/34/hola/mundo
• /pagina1/hola_mundo/_

Es decir que si no tiene nada tras la segunda barra o tiene algo mas allá de la tercera barra el path no casará.

¿Qué pasa si queremos 2 variables porque nos interesan 2 barras? Se pueden definir simplemente 2 variables, como en el siguiente ejemplo:

  $routeProvider.when('/pagina2/:variable1/:variable2', {
    templateUrl: "pagina2.html",
    controller: "Pagina2Controller"
  });

Vamos ahora a poner ejemplos de posibles paths que casarían con la ruta que acabamos de definir y el valor de las variables variable1 y variable2.

Tambien podemos definir partes estáticas entre las variable sin ningún problema como en:

  $routeProvider.when('/pagina3/rojo/:variable1/verde/:variable2/azul', {
    templateUrl: "pagina3.html",
    controller: "Pagina3Controller"
  });

Vamos ahora a poner ejemplos de posibles paths que casarían con la ruta que acabamos de definir y el valor de las variables variable1 y variable2.

Hemos visto cómo podemos definir exactamente la forma de la ruta pero con parámetros, pero ¿qué ocurre si no sabemos cuántas partes tiene la ruta? AngularJS nos permite añadir un “*” asterisco a la ruta y casará con cualquier tamaño.

  $routeProvider.when('/pagina4/:variable1*', {
    templateUrl: "pagina4.html",
    controller: "Pagina4Controller"
  });

Como en el caso anterior, también podríamos definir partes estáticas antes o después o varias variables.

Por último , ¿qué pasa si hay partes de la ruta que pueden o no pueden estar? AngularJS nos permite añadir una incógnita al final de parámetro.

  $routeProvider.when('/pagina5/:variable1?', {
    templateUrl: "pagina5.html",
    controller: "Pagina5Controller"
  });

Si no está la parte optativa su valor será undefined.

Como en el caso anterior también podríamos definir partes estáticas antes o después o varias variables. Y por supuesto se pueden mezclar todo lo que hemos visto en la misma ruta.

Ahora que hemos definido el parámetro, tenemos que poder obtener dicho valor. El valor se usa en el controlador ya que el controlador es el código JavaScript que está asociado a la página que acaba de cargarse gracias a la ruta.

La forma de obtener el valor es simplemente llamando al servicio $routeParams. Este servicio contiene tantas propiedades como parámetros hayamos definido en la ruta. Y el valor de cada propiedad del servicio es el valor de cada parámetro de la ruta.

Suponiendo la siguiente ruta:

$routeProvider.when('/pagina2/:variable1/:variable2', {
  templateUrl: "pagina2.html",
  controller: "Pagina2Controller"
});

Podemos acceder a esos parámetros de la siguiente forma:

app.controller("Pagina2Controller", ["$scope","$routeParams",function($scope,$routeParams) {
   $scope.mensaje="variable1='" + $routeParams.variable1 + "' y variable2='" + $routeParams.variable2 + "'";
}]);

• Línea 1: Inyectamos el servicio de $routeParams
• Línea 2: Hacemos uso de las propiedades $routeParams.variable1 y $routeParams.variable2 que contiene los valores de los parámetros variable1 y variable2

Como vemos es muy sencillo obtener el valor de los parámetros de las rutas.

Si la URL real incluye Query String también se pueden acceder a esos valores desde $routeParams.

Por ejemplo si la URL fuera:

/pagina2/hola/mundo?idCuenta=345&importe=678

Las propiedades de $routeParams tendrían el siguiente valor:

En este ejemplo hemos puesto todas las rutas que hemos visto en este tema y ejemplos de llamadas a ellas.

• $routeProvider
• $routeParams