Archivo de la etiqueta: tutorial ionic en espa帽ol

Como crear componentes personalizados con Ionic

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

Hola a todos:

En posts anteriores hemos aprendido a crear nuestras apps multiplataforma con Ionic.
Ionic nos ofrece un mont贸n de componentes ya creados para utilizar en nuestras apps y realmente nos permiten con poco esfuerzo crear una interfaz funcional para nuestras aplicaciones.

En el siguiente enlace tienes el 铆ndice para acceder al resto de entradas de este tutorial:

Sin embargo hay momentos que puede interesarnos crear nuestros propios componentes personalizados.

Un componente es simplemente algo que podemos mostrar las veces que queramos en la pantalla, como si fuese una etiqueta html, solo que a su vez un componente puede estar formado por etiquetas html y otros componentes.

Para ver mejor como podemos crear nuestro propios componentes personalizados en Ionic vamos a crear un proyecto de prueba al que vamos a llamar miComponente:

ionic start miComponente blank

Una vez creado el proyecto si聽 entramos en home.ts veremos esto:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  constructor(public navCtrl: NavController) {

  }

}

En Ionic todo son componentes, de hecho las p谩ginas de nuestra aplicaci贸n son componentes, si nos fijamos tiene un decorador @Component por lo que podemos ver que la propia pagina es un componente聽 que tiene el selector 鈥page-home鈥 y como plantilla utiliza el archivo home.html.

Vamos a crear un sencillo componente al que vamos a llamar saludar, para ello vamos a echar mano de ionic generator, nos situamos dentro la carpeta de聽 nuestro proyecto en la consola de comandos y tecleamos lo siguiente:

ionic g component saluda

Con esto se habr谩 creado una nueva carpeta llamada components y dentro una carpeta llamada saluda que al igual que las p谩ginas contiene un archivo .ts como controlador, un archivo .scss para los estilos y su plantilla .html.

Si observamos lo que contiene el archivo saluda.html vemos que simplemente muestra el contenido de la variable text dentro de un div:

<!-- Generated template for the SaludaComponent component -->
<div>
  {{text}}
</div>

Vemos que text est谩 definida en el controlador saluda.ts y contiene la famosa frase 鈥淗ello Word鈥

import { Component } from '@angular/core';

/**
聽* Generated class for the SaludaComponent component.
聽*
聽* See https://angular.io/api/core/Component for more info on Angular
聽* Components.
*/
@Component({
  selector: 'saluda',
  templateUrl: 'saluda.html'
})
export class SaludaComponent {

  text: string;

  constructor() {
    console.log('Hello SaludaComponent Component');
    this.text = 'Hello World';
  }

}

Como vemos el controlador de un componente es pr谩cticamente igual que el de una p谩gina.

Tenemos el decorador聽@Component聽donde se indica que su selector es ‘saluda‘ y la plantilla que utiliza es saluda.html.

Para poderlo utilizar tenemos que importar y declarar el componente en app.module.ts:

import { BrowserModule } from '@angular/platform-browser';
import { ErrorHandler, NgModule } from '@angular/core';
import { IonicApp, IonicErrorHandler, IonicModule } from 'ionic-angular';
import { SplashScreen } from '@ionic-native/splash-screen';
import { StatusBar } from '@ionic-native/status-bar';

import { MyApp } from './app.component';
import { HomePage } from '../pages/home/home';
import { SaludaComponent } from '../components/saluda/saluda';


@NgModule({
  declarations: [
    MyApp,
    HomePage,
    SaludaComponent
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp)
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    HomePage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

Para utilizarlo en la p谩gina home editamos el archivo home.html y a帽adimos la etiqueta con el componente que acabamos de crear:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ionic Blank
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
  <saluda></saluda>
</ion-content>

As铆 de f谩cil.

Si ejecutamos nuestra app de ejemplo con ionic serve -l veremos algo similar a esto:

 

A nuestro componente le podemos a帽adir tambi茅n atributos personalizados.
Por ejemplo podemos pasarle un atributo que se llame nombre de esta manera:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ionic Blank
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
 <saluda nombre="Eduardo"></saluda>
</ion-content>

Luego en el controlador definimos el par谩metro de entrada con el decorador Input de la siguiente manera:

import { Component, Input } from '@angular/core';

/**
聽* Generated class for the SaludaComponent component.
聽*
聽* See https://angular.io/api/core/Component for more info on Angular
聽* Components.
*/
@Component({
  selector: 'saluda',
  templateUrl: 'saluda.html'
})
export class SaludaComponent {

  text: string;
  @Input('nombre') nombre : string;

  constructor() {
    console.log('Hello SaludaComponent Component');
    this.text = 'Hello World';
  }

}

Para poder utilizar el decorador Input debemos importarlo primero.

Ahora podemos hacer que en lugar de saludar al mundo con “Hello Word” salude a la persona que recibamos en el par谩metro nombre:

import { Component, Input } from '@angular/core';

/**
聽* Generated class for the SaludaComponent component.
聽*
聽* See https://angular.io/api/core/Component for more info on Angular
聽* Components.
*/
@Component({
  selector: 'saluda',
  templateUrl: 'saluda.html'
})
export class SaludaComponent {

  text: string;
  @Input('nombre') nombre : string;

  constructor() {
    console.log('Hello SaludaComponent Component');
    this.text = 'Hola '+this.nombre;
  }

}

Bien, si como en el ejemplo hemos pasado “Eduardo” al par谩metro nombre cabr铆a esperar ver en pantalla “Hola Eduardo”, sin embargo comprobamos que muestra聽“Hola undefined”, a no ser que tus padres te hayan puesto de nombre undefined hay algo que no est谩 funcionando.

Eso eso es porque estamos accediendo a la variable this.nombre desde el constructor, y en el momento que se ejecuta el constructor aun no est谩n accesibles los par谩metros que recibimos en nuestro componente,聽para ello utilizamos ngOnInit:

/**
聽* Generated class for the SaludaComponent component.
聽*
聽* See https://angular.io/api/core/Component for more info on Angular
聽* Components.
聽*/
@Component({
  selector: 'saluda',
  templateUrl: 'saluda.html'
})
export class SaludaComponent {

聽聽text: string;
  @Input('nombre') nombre : string;

  constructor() {
    console.log('Hello SaludaComponent Component');
  }


  ngOnInit(){
    this.text = 'Hola '+this.nombre;
  }


}

Ahora podemos comprobar que muestra el nombre que le hayamos pasado.

Tambi茅n podemos utilizar la la variable nombre directamente en la plantilla de nuestro componente de esta manera:

<!-- Generated template for the SaludaComponent component -->
<div>
  Hola {{ nombre }}
</div>

Por ultimo si en lugar de pasarle directamente el nombre al componente queremos utilizar una variable debemos poner el par谩metro entre corchetes , por ejemplo imaginemos que tenemos un array de usuarios聽 y queremos saludarles a todos, en home.ts definiriamos un array de usuarios:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  usuarios: any = [
    { 
      nombre: 'Eduardo',
      edad: 41
    },
    { 
      nombre: 'Pedro',
      edad: 28
    },
    { 
      nombre: 'Francisco',
      edad: 34
    },
    { 
      nombre: 'Maria',
      edad: 43
    }
  ]

  constructor(public navCtrl: NavController) {

  }

}

Ahora en home.html podemos recorrer el array con *ngFor y mostrar nuestro componente saludo pas谩ndole la variable usuario.nombre:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ionic Blank
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
 <saluda  *ngFor="let usuario of usuarios" [nombre]="usuario.nombre"></saluda>
</ion-content>

Como podemos ver en este caso el par谩metro nombre va entre corchetes []聽聽ya que lo que le pasamos no es un texto literal sino una variable.

Si probamos este ejemplo veremos algo como esto:

Este ejemplo es muy sencillo y es solo para explicar como funcionan los componentes en Ionic, evidentemente no merece la pena crear un componente que solo contenga un div y un texto, pero podemos ampliar nuestro componente a帽adiendo una imagen o una ficha completa con los datos del usuario, o cualquier otro elemento que se nos ocurra.

Espero que estos sencillos ejemplos sirvan para comprender como crear componentes personalizados en Ionic.

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Como crear una app multi idioma con Ionic

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

Hola a todos, hoy vamos a aprender como crear una app multi idioma con Ionic.

Como siempre vamos a crear una app de ejemplo as铆 que desde consola creamos un nuevo proyecto al que vamos a llamar ejemploidioma:

ionic start ejemploidioma blank --cordova

Con –cordova le indicamos que incluya apache cordova para poder generar el c贸digo para android e ios.

Para crear un app multi idioma con Ionic vamos a instalar la librer铆a聽聽ngx-translate:

npm install npm install @ngx-translate/core @ngx-translate/http-loader --save

Ahora en聽app.module.ts聽tenemos que a帽adir los siguientes imports:

import { TranslateModule, TranslateLoader } from "@ngx-translate/core";
import { TranslateHttpLoader } from "@ngx-translate/http-loader";
import { HttpClient, HttpClientModule } from "@angular/common/http";

Justo debajo de los imports, antes de @NgModule a帽adimos el siguiente c贸digo:

export function HttpLoaderFactory(httpClient: HttpClient) {
  return new TranslateHttpLoader(httpClient, "../assets/i18n/", ".json");
}

Por 煤ltimo declaramos dentro de imports lo que esta marcado en amarillo:

@NgModule({
  declarations: [
    MyApp,
    HomePage
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp),
    HttpClientModule,
    TranslateModule.forRoot({
          loader: {
              provide: TranslateLoader,
              useFactory: HttpLoaderFactory,
              deps: [HttpClient]
          }
      })
 
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    HomePage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})

El c贸digo completo de聽app.module.ts聽quedar铆a de la siguiente manera:

import { BrowserModule } from '@angular/platform-browser';
import { ErrorHandler, NgModule } from '@angular/core';
import { IonicApp, IonicErrorHandler, IonicModule } from 'ionic-angular';
import { SplashScreen } from '@ionic-native/splash-screen';
import { StatusBar } from '@ionic-native/status-bar';

import { MyApp } from './app.component';
import { HomePage } from '../pages/home/home';

import { TranslateModule, TranslateLoader } from "@ngx-translate/core";
import { TranslateHttpLoader } from "@ngx-translate/http-loader";
import { HttpClient, HttpClientModule } from "@angular/common/http";

export function HttpLoaderFactory(httpClient: HttpClient) {
  return new TranslateHttpLoader(httpClient, "../assets/i18n/", ".json");
}

@NgModule({
  declarations: [
    MyApp,
    HomePage
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp),
    HttpClientModule,
    TranslateModule.forRoot({
          loader: {
              provide: TranslateLoader,
              useFactory: HttpLoaderFactory,
              deps: [HttpClient]
          }
      })
 
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    HomePage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

Ahora vamos a editar聽app.component.ts聽 y a帽adimos el siguiente c贸digo:

import { Component } from '@angular/core';
import { Platform } from 'ionic-angular';
import { StatusBar } from '@ionic-native/status-bar';
import { SplashScreen } from '@ionic-native/splash-screen';
import { TranslateService } from '@ngx-translate/core';

import { HomePage } from '../pages/home/home';

@Component({
  templateUrl: 'app.html'
})
export class MyApp {
  rootPage:any = HomePage;

  constructor(platform: Platform, statusBar: StatusBar, splashScreen: SplashScreen, private translateService: TranslateService) {
    platform.ready().then(() => {
      // Okay, so the platform is ready and our plugins are available.
      // Here you can do any higher level native things you might need.
      this.translateService.setDefaultLang('es');
      this.translateService.use('es');

      statusBar.styleDefault();
      splashScreen.hide();
    });
  }
}

Con this.translateService.setDefaultLang(‘es’);聽le idicamos que el idioma por defecto es el espa帽ol y con this.translateService.use(‘es’);聽hacemos que sea el idioma seleccionado.

Dentro de la carpeta聽src/assets聽vamos a crear una carpeta llamada聽i18n聽y dentro de esta situaremos los archivos con los literales en los diferentes idiomas, en este ejemplo vamos a usar ingl茅s y espa帽ol, por lo que vamos a crear dos archivos llamados en.json para ingl茅s y es.json para espa帽ol:

En en.json聽pondremos聽 lo siguiente:

{
  "HOLA": "Hi {{ value }}",
  "IDIOMA": "Language",
  "BIENVENIDO" : "Welcome"
}

 

Y en es.json:

{
  "HOLA": "Hola {{ value }}",
  "IDIOMA": "Idioma",
  "BIENVENIDO" : "Bienvenido"
}

 

Como puedes observar es un archivo en formato json donde la clave es lo que escribiremos en la vista y聽 el valor es lo que se mostrar谩 en funci贸n del idioma seleccionado.

Como puedes ver HOLA se traduce como “Hola {{ value }}”, donde value se sustituir谩 por el valor pasado, veremos un poco m谩s adelante como se utiliza.

Ya estamos preparados para traducir聽 nuestra app.

Vamos a modificar home.html聽y vamos a crear un ejemplo sencillo donde vamos a tener un elemento ion-card que simplemente nos da la Bienvenida y nos saluda y un selector para cambiar de idioma:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ejemplo Idioma
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
  <ion-card>
    <ion-card-header text-center>
      {{ 'BIENVENIDO' | translate }}
    </ion-card-header>
      
    <ion-card-content>
      <p text-center>
        {{ 'HOLA' | translate:{value: 'Eduardo'} }} 
      </p>
    </ion-card-content>
  </ion-card>

  <ion-item>
    <ion-label>{{ 'IDIOMA' | translate }} </ion-label>
    <ion-select [(ngModel)]="idioma" (ionChange)="cambioIdioma($event)">
      <ion-option value="es">Espa帽ol</ion-option>
      <ion-option value="en">Ingl茅s</ion-option>
    </ion-select>
  </ion-item>
</ion-content>

Como vemos en la etiqueta ion-select le decimos que en el evento聽(ionChange) llame a la funci贸n cambioIdioma($event), $event contendr谩 la opci贸n seleccionada.

Para traducir las cadenas al idioma seleccionado utilizamos en pipe o barra vertical ‘|’聽seguido de la palabra translate聽que es filtro que se aplica.

Como coment茅 antes podemos pasarle un valor al filtro translate de la siguiente manera:

{{ ‘HOLA’ | translate:{value: ‘Eduardo’} }}

Con esto le estamos diciendo que traduzca la cadena HOLA y le pase al fintro el value ‘Eduardo’.

Al ir a buscar el valor en el archivo json sustituir谩 val煤e por ‘Eduardo’:

“HOLA”: “Hi {{ value }}”,

Esto puede servirnos de ayuda cuando queremos traducir cadenas mostrando un valor que dependiendo del idioma se debe mostrar en una posici贸n diferente de la cadena, por ejemplo la frase “Este es el coche de Eduardo” en ingl茅s ser铆a “this is Eduardo’s car”.

Por lo tanto en ingl茅s podr铆amos pasarle el nombre y traducirlo as铆:
“this is {{ value }}’s car”,

Mientras que en espa帽ol ser铆a
“Este es el coche de {{ value }}”

Bien, ahora solo nos queda definir la funci贸n聽cambioIdioma聽en el controlador home.ts,聽para poder cambiar de idioma necesitaremos importar TranslateService聽e inyectarlo en el constructor:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';
import { TranslateService } from '@ngx-translate/core';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  constructor(public navCtrl: NavController, private translateService: TranslateService) {

  }

  cambioIdioma(selectedValue){
    this.translateService.use(selectedValue);
  }

}

Con selectedValue es el idioma que hemos seleccionado en el select y con聽this.translateService.use(selectedValue)聽le estamos diciendo que utilice el idioma que le pasamos.

Ya podemos probar nuestro peque帽o ejemplo, ejecutando ionic serve -l聽desde consola veremos algo como esto en nuestro navegador:

Ejemplo de app multi idioma con ionic
Ejemplo de app multi idioma con ionic

Por 煤ltimo, como extra si desde el controlador necesitamos traducir una cadena podemos utilizar聽this.translateService.instant().

Por ejemplo si queremos mostrar un loading y que se muestra cargando en el idioma seleccionado, teniendo ya definido el literal cargando en los ficheros .json podemos hacer lo siguiente:
this.loading = this.loadingCtrl.create({
      content: this.translateService.instant('Cargando'),
      spinner: 'dots',
    });
Hay que tener e cuenta que聽 translate.instant es s铆ncrono, por lo que tenemos que estar seguros de que聽 los archivos lang聽 han sido cargados para obtener traducciones.
En su lugar tambi茅n se puede utilizar translate.get, que devuelve un elemento observable.
Para saber m谩s sobre聽ngx-translate podeis visitar su p谩gina oficial en http://www.ngx-translate.com/
Eso es todo por hoy, espero que te sea de utilidad.

 

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Directiva para mostrar y ocultar men煤 al hacer scroll en Ionic

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

En el siguiente enlace tienes el 铆ndice para acceder al resto de entradas de este tutorial:

Hola a todos:

El post de hoy es por cortes铆a de Miguel Escribano.

Miguel ha realizado una app en ionic para consultar las noticias de men茅ame que est谩 realmente bien y que pod茅is encontrar en google play en el siguiente enlace:

https://play.google.com/store/apps/details?id=com.miguelescribano.meneame

Bi茅n, Miguel聽聽que ha querido colaborar aportando una directiva para mostrar u ocultar un men煤 o barra de herramientas al hacer scroll:

Una directiva es un tipo de componente pensado para cambiar el comportamiento de un elemento ya existente en el DOM. 聽A diferencia de un componente normal este no necesita de una plantilla sino que se incrustara en una existente para manipularla.

El objetivo aqu铆 es esconder una barra de navegaci贸n al hacer scroll hacia abajo y que aparezca cuando hacemos scroll hacia arriba.

En ionic el evento de scroll se produce en el content, por tanto dicha barra ha de encontrarse dentro de ion-content.

Vamos a crear un proyecto de prueba para mostrar como funciona esta directiva:

ionic start hideMenu blank

Vamos a editar home.ts聽y le vamos a a帽adir un array con los items que mostraremos en el listado, por ejemplo una lista de videojuegos:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  items = [
    'Pokemon Yellow',
    'Super Metroid',
    'Mega Man X',
    'The Legend of Zelda',
    'Pac-Man',
    'Super Mario World',
    'Street Fighter II',
    'Half Life',
    'Final Fantasy VII',
    'Star Fox',
    'Tetris',
    'Donkey Kong III',
    'GoldenEye 007',
    'Doom',
    'Fallout',
    'GTA',
    'Halo',
    'Warcraft II'
  ];

  constructor(public navCtrl: NavController) {

  }

}

Ahora vamos a editar home.html y a帽adimos el siguiente c贸digo en amarillo en ion-content para generar la toolbar y los items de prueba:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ionic Blank
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content hide-menu>

      <ion-toolbar no-border-top class='show-header'>
          <ion-segment color='secondary' [(ngModel)]="section">
            <ion-segment-button value="portada">
              Portada
            </ion-segment-button>
            <ion-segment-button  value="nuevas" >
              Nuevas
            </ion-segment-button>
            <ion-segment-button  value="populares">
              Populares
            </ion-segment-button>
            <ion-segment-button  value="mas_visitadas">
              + Visitadas
            </ion-segment-button>
          </ion-segment>
        </ion-toolbar>

    <ion-list>
      <button ion-item *ngFor="let item of items" (click)="itemSelected(item)">
        {{ item }}
      </button>
    </ion-list>
</ion-content>

Como pod茅is ver en la etiqueta ion-content hemos a帽adido hide-menu聽 que es el nombre de la directiva que vamos a crear.

Despu茅s hemos a帽adido una聽 ion-toolbar con ion-segment聽 y cuatro opciones que ser谩 la barra de men煤 que vamos a mostrar u ocultar.

Por ultimo mostramos un listado donde mostramos con *ngFor los items que hemos definido en el controlador.

V茅ase que de entrada la barra tiene la clase show-header. Incluiremos esta y hide-header en la listado.scss con la intenci贸n de hacerla aparecer y desaparecer respectivamente.

Tambi茅n necesitamos definir la posici贸n de聽ion-tollbar como fixed.

Suponiendo que nuestro header principal (ion-header) tiene la altura 56px por defecto incluiremos lo siguiente en listado.scss:

page-home {

    ion-toolbar {
        position:fixed;
    }

    .hide-header{
        top: 0px;
    }

    .show-header{
        top: 56px;
    }
   
 }

Ya solo queda crear la directiva, para ello vamos a utilizar ionic generator:

ionic g directive hide-menu

Al generar la directiva nos habr谩 creado una carpeta directives y dentro estar谩 la carpeta hide-menu con la directiva que acabamos de crear.

Necesitamos declarar la directiva en app.module.ts,聽por lo tanto lo editamos y a帽adimos lo siguiente:

import { BrowserModule } from '@angular/platform-browser';
import { ErrorHandler, NgModule } from '@angular/core';
import { IonicApp, IonicErrorHandler, IonicModule } from 'ionic-angular';
import { SplashScreen } from '@ionic-native/splash-screen';
import { StatusBar } from '@ionic-native/status-bar';

import { MyApp } from './app.component';
import { HomePage } from '../pages/home/home';
import { HideMenuDirective } from '../directives/hide-menu/hide-menu';

@NgModule({
  declarations: [
    MyApp,
    HomePage,
    HideMenuDirective
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp)
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    HomePage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

Ahora editamos el archivo hide-menu.ts聽de nuestra directivay vamos a importar聽e inyectar en el constructor ElementRef,聽 Renderer2, que necesitaremos para manipular los elementos de la vista:

import { Directive, ElementRef, Renderer2  } from '@angular/core';

/**
聽* Generated class for the HideMenuDirective directive.
聽*
聽* See https://angular.io/api/core/Directive for more info on Angular
聽* Directives.
聽*/
@Directive({
  selector: '[hide-menu]' // Attribute selector
})
export class HideMenuDirective {

  constructor(public element:ElementRef, public renderer:Renderer2) {
    console.log('Hello HideMenuDirective Directive');
  }

}

Vemos que en el decorador @Directive viene definido el selector que es el que tenemos que poner en el elemento de la vista al que queremos aplicar la directiva.

Ahora en la definici贸n de la directiva a la propiedad聽host聽le vamos a asignar el evento ionScroll聽y le indicamos que ejecute la funci贸n handleScroll que definiremos despu茅s. Host hace referencia al elemento donde estamos aplicando la directiva, en este caso se lo estamos asignando al elemento ion-content:

@Directive({
  selector: '[hide-menu]', // Selector de la directiva
  host: {
    '(ionScroll)': 'handleScroll($event)' // Captura el evento scroll (ionScroll) dentro de ion content y env铆a el evento a su manejador handleScroll
  }
})

Ahora necesitamos definir tres variables:

toolBarRef – Hace referencia a la toolbar que vamos a mostrar u ocultar.
storedScroll – Guardar谩 la posici贸n del scroll.
threshold – Contendr谩 la distancia que tenemos que mover el scroll para que se oculte la barra.
export class HideMenuDirective {


  private toolBarRef:any;

  private storedScroll: number = 0;
  private threshold: number = 10;


  constructor(public element:ElementRef,
              public renderer:Renderer2) {
  }

Una vez definidas las variables en ngOnInit 聽hacemos que toolBarRef聽 referencie al elemento del DOM que contiene la barra,聽聽ngOnInit聽se ejecuta una 煤nica vez al iniciar,聽 es parecido al constructor:

ngOnInit() {
    //Con esto conseguimos referenciar la barra de navegacion mediante su clase.
    this.toolBarRef = this.element.nativeElement.getElementsByClassName("toolbar")[0];
  }

Una vez hecho esto ya podemos definir la funci贸n handleScroll聽que como hemos indicado se ejecutar谩 al hacer scroll sobre el elemento ion-content al que hemos asignado la directiva:

handleScroll(event) {
    if (event.scrollTop - this.storedScroll > this.threshold) {
      //al hacer scroll down hace desaparecer la barra mediante clases
      this.renderer.addClass(this.toolBarRef,'hide-header');
      this.renderer.removeClass(this.toolBarRef,'show-header');
    } else if (event.scrollTop - this.storedScroll < 0) {
       //al hacer scroll up la hace aparecer de nuevo
      this.renderer.removeClass(this.toolBarRef,'hide-header');
    }
    //actualizmos la ultima posicion conocida del scroll proveniente del evento
    this.storedScroll = event.scrollTop;
  }

En esta funci贸n comprobamos si la posici贸n actual del scroll (event.scrollTop) menos la posici贸n anterior es mayor que el limite (threshold), si es as铆 es que estamos haciendo scroll hacia abajo por lo tanto con this.renderer.addClass le a帽adimos a la toolbar la clase hide-header que har谩 que se oculte la barra y con removeClass eliminamos la clase show-header que tenia.

En caso contrario significa que estamos haciendo scroll hacia arriba por lo tanto eliminamos la clase hide-header que oculta la barra, lo que har谩 que esta se vuelva a mostrar.

El c贸digo completo de la directiva quedar铆a as铆:

import { Directive, ElementRef, Renderer2 } from '@angular/core';

@Directive({
  selector: '[hide-menu]', //selector de la directiva
  host: {
    '(ionScroll)': 'handleScroll($event)' //Captura el evento scroll (ionScroll) dentro de ion content y envia el evento a su manejador handleScroll
  }
})
export class HideMenuDirective {

  //Varaibles para referenciar la barra 
  private toolBarRef:any;

  //Variables para saber la direccion del scroll
  private storedScroll: number = 0;
  private threshold: number = 10;


  constructor(public element:ElementRef,
              public renderer:Renderer2) {
  }

  ngOnInit() {
    //Con esto conseguimos referenciar la barra de navegacion mediante su clase.
    this.toolBarRef = this.element.nativeElement.getElementsByClassName("toolbar")[0];

  }

  handleScroll(event) {
    if (event.scrollTop - this.storedScroll > this.threshold) {
      //al hacer scroll down hace desaparecer la barra mediante clases
      this.renderer.addClass(this.toolBarRef,'hide-header');
      this.renderer.removeClass(this.toolBarRef,'show-header');
    } else if (event.scrollTop - this.storedScroll < 0) {
       //al hacer scroll up la hace aparecer de nuevo
      this.renderer.removeClass(this.toolBarRef,'hide-header');
    }
    //actualizmos la ultima posicion conocida del scroll proveniente del evento
    this.storedScroll = event.scrollTop;
  }
}

Si ejecut谩is el ejemplo con ionic serve -l obtendreis algo como esto:

Bien, eso es todo por hoy, solo me resta agradecer a Miguel Escribano por su aporte y recomendaros que descargu茅is su app meneame.

 

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Mostrar un mapa offline en Ionic con Leaflet

En el siguiente enlace tienes el 铆ndice para acceder al resto de entradas de este tutorial:

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

Hola a todos:

En posts anteriores vimos como mostrar un mapa de Google maps en ionic, sin embargo 驴que pasa si queremos mostrar informaci贸n en un mapa sin conexi贸n?, google maps no nos podr谩 mostrar el mapa.

En lugar de utlizar Google maps en esta ocasi贸n vamos a utilizar Leaflet para mostrar un mapa.

Leaflet聽 es una biblioteca javascript de c贸digo abierto que nos permite crear mapas.

Lanzado por primera vez en 2011,聽es compatible con la mayor铆a de las plataformas m贸viles y de escritorio, y es compatible con聽HTML5聽y聽CSS3聽.

Es una de las bibliotecas de mapas de JavaScript m谩s populares y es utilizada por los sitios web como聽FourSquare聽,聽Pinterest聽y聽Flickr聽.

Para poder mostrar un mapa offline es necesario tener alojados loc谩lmente los titles que forman el mapa, si quieres mostrar un mapa de todo el mundo offline a d铆a de hoy podemos afirmar聽 que es inviable ya que eso supondr铆a much铆simos gigas de informaci贸n, sin embargo si que puede ser viable mostrar un mapa offline de una ciudad.

Si por ejemplo est谩s desarrollando una aplicaci贸n de turismo de una ciudad concreta donde vas a mostrar en un mapa聽 los monumentos que merece la pena visitar en dicha ciudad, o cualquier otra informaci贸n geolocalizada en un mapa, puede ser interesante el poder mostrar un mapa sin necesidad de tener conexi贸n a Internet en ese preciso momento.

Vamos a ver como podemos solucionar esto en ionic 3, y como siempre la mejor manera de verlo es con un ejemplo.

Lo primero que vamos ha hacer es crear un nuevo proyecto en ionic que vamos a llamar mapaoffline:

ionic start mapaoffline blank

Una vez creado el en proyecto entramos en la carpeta con:

cd mapaoffline

Ahora vamos a descargar Leaflet, para ello descargamos la 煤ltima versi贸n desde聽 la secci贸n de descargas de su p谩gina oficial en el siguiente enlace:

http://leafletjs.com/download.html

Se habr谩 descargado un archivo .zip, antes de nada debemos descomprimirlo para extraer su contenido:

 

Ahora vamos a crear una carpeta llamada leaflet en src/assets y dentro vamos a copiar la carpeta images y el archivo leaflet.css.

Una vez hecho esto vamos a cargar el archivo leaflet.css en index.html:

<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
  <meta charset="UTF-8">
  <title>Ionic App</title>
  <meta name="viewport" content="viewport-fit=cover, width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
  <meta name="format-detection" content="telephone=no">
  <meta name="msapplication-tap-highlight" content="no">

  <link rel="icon" type="image/x-icon" href="assets/icon/favicon.ico">
  <link rel="manifest" href="manifest.json">
  <meta name="theme-color" content="#4e8ef7">

  <!-- add to homescreen for ios -->
  <meta name="apple-mobile-web-app-capable" content="yes">
  <meta name="apple-mobile-web-app-status-bar-style" content="black">

  <!-- cordova.js required for cordova apps -->
  <script src="cordova.js"></script>

  <!-- un-comment this code to enable service worker
聽聽
聽聽聽聽if ('serviceWorker' in navigator) {
聽聽聽聽聽聽navigator.serviceWorker.register('service-worker.js')
聽聽聽聽聽聽聽聽.then(() => console.log('service worker installed'))
聽聽聽聽聽聽聽聽.catch(err => console.error('Error', err));
聽聽聽聽}
聽聽-->

  <link href="build/main.css" rel="stylesheet">
  <link href="assets/leaflet/leaflet.css" rel="stylesheet">


</head>
<body>

  <!-- Ionic's root component and where the app will load -->
  <ion-app></ion-app>

  <!-- The polyfills js is generated during the build process -->
  <script src="build/polyfills.js"></script>

  <!-- The vendor js is generated during the build process
聽聽聽聽聽聽聽It contains all of the dependencies in node_modules -->
  <script src="build/vendor.js"></script>


  <!-- The main bundle js is generated during the build process -->
  <script src="build/main.js"></script>

</body>
</html>

Ahora vamos a instalar leaflet desde consola con los siguiente comandos:

npm install leaflet --save
npm install @types/leaflet --save

Ahora que ya tenemos instalado leaflet necesitamos descargar los tiles del mapa que vamos a mostrar, para ello vamos a echar mano de una herramienta llamada Mobile Atlas Creator (MOBAC), para descargarla accedemos al siguiente enlace:聽http://mobac.sourceforge.net/聽y bajamos en la p谩gina hasta encontrar Download y pulsamos en latest stable version聽para descargar la aplicaci贸n.

Una vez descargada tenemos que descomprimir el archivo zip y dentro encontraremos el archivo ejecutable.

Al ejecutar Mobile Atlas Creator nos pide introducir un nombre para el atlas (en este caso le llamamos simplemente mapa) y el formato, tenemos que seleccionar Osmdroid ZIP.

 

Pulsamos Aceptar y nos mostrar谩 un mapa, podemos mover zoom para ver mejor la zona que queremos seleccionar. Si hacemos doble click en un punto el mapa har谩 zoom y se centrar谩 en ese punto, por ello para localizar la zona que queremos mostrar es mejor partir de un zoom que nos permita ver donde estamos e ir haciendo doble click hasta obtener la localizaci贸n y zoom que nos interesa.

En el panel de la izquierda en la secci贸n map source tenemos los mapas de los que podemos obtener los tiles, muchos son solo de una zona en concreto, yo para este ejemplo voy a utilizar OpenStreetMap4UMaps.eu聽que nos ofrece un mapa de todo el mundo.

Debajo del panel Map Source tenemos聽 el panel Zoom Levels, aqui debemos seleccionar los niveles de zoom que queremos que tenga el mapa, cabe mencionar que cuantos m谩s niveles de zoom mas tiles necesitaremos y por ende mas espacio ocupar谩n las im谩genes.

Marcamos por ejemplo 11,12,13,14, y 15.

Ahora tenemos que seleccionar la porci贸n del mapa que queremos descargar:

En la parte de arriba del mapa tenemos una barra de zoom que podemos mover para ver mejor la parte del mapa que queremos seleccionar. Con el rat贸n sobre el mapa seleccionamos un 谩rea.

Yo por ejemplo he seleccionado la zona de Bilbao, de est谩 manera podr茅 mostrar un mapa de Bilbao sin conexi贸n.

Ahora debajo del panel Zoom Levels tenemos el panel Atlas content, aqu铆 vamos a pulsar en el bot贸n聽Add Selection聽lo que nos crear谩 un Layer聽 que si lo desplegamos vemos que contiene dentro los niveles de zoom que hemos seleccionado.

Bien, una vez que hemos seleccionado el 谩rea que queremos descargar tenemos que seleccionar Create Atlas聽y聽acto seguido comenzar谩 a generar el atlas:

El atlas que se ha generado ser谩 un archico .zip con el nombre que le hemos dado al atlas en este caso mapa seguido de la fecha y hora en la que ha sido generado y lo encontrar谩s en la carpeta atlases聽dentro de la carpeta聽 donde tengas Mobile Atlas Creator.

Bien, ahora vamos descomprimir el archivo zip que nos ha generado, al descomprimir vemos que dentro de la carpeta que nos ha creado hay otra carpeta llamada 4uMaps, vamos a cambiarle el nombre a la carpeta por simplemente聽mapa聽y a copiar esta carpeta dentro de la carpeta assets de nuestro proyecto:

 

Una vez que tenemos Los tiles copiados en la carpeta assets de nuestro proyecto ya podemos mostrarlos en el mapa.

Vamos a editar home.html聽e igual que hac铆amos cuando creamos un mapa con google maps vamos a crear un div con id=”map” donde se renderizar谩 el mapa:

<ion-header>
<ion-navbar>
  <ion-title>
    Ionic Blank
  </ion-title>
</ion-navbar>
</ion-header>

<ion-content padding>
<div id="map"></div>
</ion-content>

Ahora le vamos a definir el tama帽o para que ocupe toda la pantalla por lo tanto editamos home.scss y a帽adimos lo siguiente:

page-home {
聽聽聽聽#map{
聽聽聽聽聽聽聽聽width:100%;
聽聽聽聽聽聽聽聽height: 100%;
    }
}

Ahora en home.ts vamos a ver como se crea un mapa con leaflet:

Lo primero que debemos hacer es importar leaflet:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';
import * as L from 'leaflet';

Ahora vamos a crear una variable de clase llamada map donde guardaremos la instancia del mapa que vamos a crear:

...

export class HomePage {

  map : any;

  constructor(public navCtrl: NavController) {

  }

...

Ahora cuando se haya cargado la p谩gina en el m茅todo onViewDidLoad vamos a crear el mapa de la siguiente manera:

ionViewDidLoad() {

   this.map = L.map('map').
     setView([ 43.2603479, -2.9334110],
     12);

   L.tileLayer('assets/mapa/{z}/{x}/{y}.png', {    maxZoom: 15  }).addTo(this.map);

   L.marker([ 43.2603479,-2.9334110],{draggable: true}).addTo(this.map);

 }

Para crear un mapa con Leaflet utilizamos L.map(‘map’), ‘map’ es el id del div que hemos creado en la vista home.html y que es donde se va a renderizar el mapa.

Despu茅s con el metodo .setView le indicamos las coordenadas donde se tiene que posicionar el mapa, en este caso son las del centro de Bilbao.

Con L.tileLayer()聽a帽adimos al mapa una capa de tiles que va a contener los tiles del mapa que hemos descargado, como primer par谩metro le pasamos la ruta donde se encuentran los tiles que puede ser una url si estamos utilizando un mapa online o la ruta donde se encuentrar alojados los archivos para mostrar el mapa offline como es el caso.

Si nos fijamos en la ruta vemos que es ‘assets/mapa/{z}/{x}/{y}.png’,聽聽聽z, x e y hacen referencia respectivamente al nivel de Zoom, tiles en el eje X y tiles en el eje Y.

Obtendr谩n el valor correspondiente autom谩ticamente en funci贸n de la posici贸n del mapa y al tener la carpeta de los tiles ordenada por estos par谩metros no te tienes que preocupar.

Despues con聽L.marker聽 creamos un marcador en en las coordenadas indicadas y le decimos que sea聽 arratrable (draggable) y con .addTo(this.map) lo a帽adimos a nuestro mapa.

El c贸digo completo de home.ts quedar铆a as铆:

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';
import * as L from 'leaflet';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  map;

  constructor(public navCtrl: NavController) {

  }

  ionViewDidLoad() {

    this.map = L.map('map').
      setView([ 43.2603479, -2.9334110],
      12);

    L.tileLayer('assets/mapa/{z}/{x}/{y}.jpg', {    maxZoom: 15  }).addTo(this.map);

    L.marker([ 43.2603479,-2.9334110],{draggable: true}).addTo(this.map);

  }

}

Ahora si ejecutamos nuestra app aunque no tengamos conexi贸n a internet podemos mostrar un mapa:

 

Eso es todo por hoy, como siempre espero que os sea de utilidad.

 

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Firmar el apk para subirlo a Google Play

En el siguiente enlace tienes el 铆ndice para acceder al resto de entradas de este tutorial:

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

Hola a todos,

Como el t铆tulo del post indica hoy vamos a ver c贸mo generar un archivo .apk firmado para poder subirlo a google play.

Este es el 煤ltimo paso que debemos dar una vez tenemos desarrollada y lista nuestra aplicaci贸n para poder subirla a la tienda de aplicaciones de Google.

Android exige que todos los APK se firmen digitalmente con un certificado para poder instalarse.

Cuando firmas un APK se adjunta a este el certificado de clave p煤blica que asocia el APK contigo y con tu clave privada correspondiente. Esto es necesario para poder lanzar cualquier actualizaci贸n de la app asegur谩ndose que provenga del autor original, por eso es important铆simo que guardemos el archivo聽keystore generado a buen recaudo para poder lanzar futuras actualizaciones聽ya que todas las aplicaciones deben usar el mismo certificado durante su vida 煤til.

Un keystore es un campo binario que contiene una o m谩s claves privadas.

Si desarrollas una app nativa puedes generar el keystore firmar el apk desde Android studio, nosotros vamos a ver como firmar una aplicaci贸n聽 聽generada desde ionic o apache cordova desde consola.

Para poder firmar el apk desde consola debemos seguir una serie de pasos que vamos a ver a continuaci贸n:

Lo primero que necesitamos es generar聽 el keystore:

Si por ejemplo nuestra app se llama miapp para generar un keystore聽 abrimos聽 una terminal, nos situamos en la carpeta de nuestro proyecto y escribimos el siguiente comando:

keytool -genkey -v -keystore miapp.keystore -alias miapp -keyalg RSA -keysize 2048 -validity 10000

miapp.keystore es el archivo que se va a generar, el alias es un nombre de identificaci贸n para tu clave, en este caso le hemos llamado miapp.

Con keysize le indicamos que el tama帽o de la clave sea de 2048 bits, es recomendavle dejarlo en este valor.

Por 煤ltimo con -validity聽fijamos el per铆odo de validez de tu clave en a帽os, creo que聽 con 10000 a帽os ser谩 suficiente ;-P.

Al ejecutar el comando nos pide que introduzcamos una serie de datos:

Introduzca la contrase帽a del almac茅n de claves:聽

Volver a escribir la contrase帽a nueva: 

驴Cu谩les son su nombre y su apellido?

驴Cu谩l es el nombre de su unidad de organizaci贸n?

驴Cu谩l es el nombre de su organizaci贸n?

驴Cu谩l es el nombre de su ciudad o localidad?

驴Cu谩l es el nombre de su estado o provincia?

驴Cu谩l es el c贸digo de pa铆s de dos letras de la unidad?

Te pide dos veces la contrase帽a, es importante que recuerdes la contrase帽a que has introducido ya que la necesitar谩s despu茅s.

Al final te muestra los datos que has introducido y te pide confirmaci贸n, le decimos que si:

驴Es correcto CN=Eduardo, OU=Revilla, O=revigames, L=Abadi帽o, ST=Bizkaia, C=ES?

[no]:Si

Lo que os sale debe ser algo parecido a la siguiente imagen:

Bien, con esto ya hemos generado un archivo llamado miapp.keystore en la raiz de nuestro proyecto.

Ahora vamos a crear un nuevo archivo en la聽raiz del proyecto llamado build.json, lo creamos con nuestro editor de c贸digo y dentro escribimos el siguiente c贸digo:

{
     "android": {
         "debug": {
             "keystore": "miapp.keystore",
             "storePassword": "XXXXX",
             "alias": miapp",
             "password" : "XXXX",
             "keystoreType": ""
         },
         "release": {
             "keystore": "miapp.keystore",
             "storePassword": "XXXX",
             "alias": "miapp",
             "password" : "XXXX",
             "keystoreType": ""
         }
     }
 }

El primero es para la versi贸n de debug y “release” es para la versi贸n final que vas a subir a la play store.

En el campo keystore debes poner la ruta del archivo .keystore que acabamos de generar, si lo has generado en la ra铆z solo debes de poner el nombre del archivo, en este caso miapp.keystore.

En alias ponemos el alias que hemos puesto al crear el archivo

Despu茅s en storePassword debe poner la聽contrase帽a del almac茅n de claves que indicaste al crear el archivo.

En password debemos poner la contrase帽a.

Guardamos el archivo y ya solo nos queda generar el apk firmado con el siguiente comando:

ionic cordova build android --release

Si no ha detectado errores y se ha compilado bien podr谩s encontrar el apk firmado que debes subir a play store en la siguiente ruta dentro de tu aplicaci贸n:

/platforms/android/build/outputs/apk/android-release.apk

Eso es todo por hoy, espero que os haya sido de utilidad y ver vuestras apps triunfando en la play store pronto ;-).

Aprovecho para deciros que si has creado alguna app con ionic y la tienes en la play store puedes compartirlo en los comentarios, as铆 servir谩 como inspiraci贸n para que otras personas puedan ver lo que se puede crear con ionic y al mismo tiempo seguro que gan谩is alguna descarga extra que siempre viene bien 馃槈

 

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Libro: Desarrollo de aplicaciones m贸viles multiplataforma y PWAs con Ionic y Firebase desde cero.

Hola a todos,

Como dir铆a Francisco Umbral, 隆He venido a hablar de mi libro! ;-P

Hoy vengo a anunciaros que por fin he publicado en Amazon mi libro para aprender a programar aplicaciones multiplataforma con ionic.

Ionic es un framework que nos permite crear de una manera r谩pida y sencilla aplicaciones m贸viles multiplataforma (Android, IOS, Windows, PWAs…) utilizando tecnolog铆as web (HTML, JAVASCRIPT, CSS), por lo que si eres desarrollador web podr谩s reciclar tus conocimientos y crear aplicaciones m贸viles de una manera sencilla.

En este libro aprender谩s de una manera sencilla y con una curva de aprendizaje suave todo lo necesario para crear aplicaciones m贸viles con ionic desde cero.

La principal ventaja de utilizar Ionic es que es multiplataforma, es decir que con un mismo c贸digo podemos generar apps para Android, IOS y Windows, por lo que el tiempo y coste de desarrollo y mantenimiento de una app se reduce sensiblemente.

Otra ventaja es que si dispones de conocimientos previos en desarrollo web frontend ya tienes medio camino andado ya que la curva de aprendizaje ser谩 mucho menor.
Adem谩s Ionic dispone de muchos componentes ya creados para que sin apenas esfuerzos puedas desarrollar una app de apariencia profesional sin necesidad de ser un gran dise帽ador.

El libro est谩 en espa帽ol por lo que ser谩 de especial utilidad para aquellos que no se arreglen bien con el ingl茅s.

El prop贸sito del libro es hacer la curva de aprendizaje lo m谩s suave posible, empezando a desarrollar cosas pr谩cticas desde el principio y aprendiendo cosas nuevas seg煤n las vamos necesitando en lugar de abrumaros con mucha teor铆a al principio sin ver su aplicaci贸n pr谩ctica, ya creo que esto puede hacer que muchos desistan por el camino.

En cambio es mucho m谩s motivador ver que nada m谩s empezar se puede hacer cosas que funcionan aunque sean sencillas y ir sobre la marcha aprendiendo conceptos a medida que los vamos necesitando.

Para que te hagas una idea del contenido del libro te muestro el 铆ndice con el contenido del mismo:

  • Introducci贸n
    • 驴Qu茅 es ionic?
    • Ventajas de utilizar ionic para desarrollar apps
    • Desventajas de utilizar ionic para desarrollar apps
    • Diferencia entre Ionic 1, ionic 2 y 3 e Ionic 4
  • C贸mo obtener el c贸digo de los ejemplos de este libro
  • Instalar ionic y las herramientas necesarias para el desarrollo
    • Instalar Node.js
    • Instalar ionic
    • Instalar Android studio.
    • En windows
    • Instalar Android Studio en Mac
    • Instalar un editor de c贸digo compatible con TypeScript
  • Hola Mundo en Ionic
  • Estructura de un proyecto Ionic
  • Modificando nuestro hola mundo
  • Mini Juego de acertar n煤meros
  • Personalizando el dise帽o de nuestra aplicaci贸n
    • Variables SASS y Variables CSS4
    • Colores
    • Utilidades CSS – Estilos predefinidos
    • Alineaci贸n del texto
    • Transformaci贸n de texto
    • Atributos de Texto seg煤n tama帽o de pantalla
    • Emplazamiento de elementos
    • Elementos float
    • Elementos Flotantes seg煤n tama帽o de pantalla
    • Visualizaci贸n de elementos
    • Visualizaci贸n u ocultaci贸n de elementos en funci贸n del tama帽o de la pantalla
    • Espaciado del contenido
    • Padding
    • Margin
  • Navegaci贸n
    • Ionic Generator
    • Navegar entre p谩ginas utilizando routerLink en la plantilla html
    • Navegar entre p谩ginas program谩ticamente
    • Volver a la p谩gina anterior
    • Pasando datos entre p谩ginas
    • Men煤 lateral
    • Navegaci贸n por Tabs
  • Pipes
  • Creando una aplicaci贸n para guardar nuestros sitios geolocalizados
    • Descripci贸n de la aplicaci贸n
    • Mostrando el mapa
    • Promesas y Async/Await
    • Iniciando el mapa
    • A帽adiendo un marcador al mapa
    • A帽adiendo FAB
    • Modales
    • Creando el formulario
    • Utilizando la c谩mara
    • Creando un Service
    • Probando nuestra aplicaci贸n misSitios en el m贸vil
    • Ejecutar nuestra aplicaci贸n en un dispositivo android:
    • Ejecutar nuestra aplicaci贸n en un dispositivo iOS:
    • Guardando nuestros sitios en una base de datos local
    • Ionic storage
    • Mostrar el detalle del sitio
    • Modificar nuestros sitios
    • Eliminar un sitio desde el listado deslizando el item con 鈥淚temSliding鈥
    • Alerts
  • Preparar la app para la publicaci贸n usando capacitor
    • Generar el splash screen y los iconos en Android
    • Generar el splash screen y los iconos en iOS
    • Generar ejecutable firmado para poder subirlo a google play.
  • Ionic Native y Capacitor
  • Componentes personalizados
  • Peticiones http
    • http.get
    • Promesas y Observables
    • http.post
  • Firebase
    • Autenticaci贸n con correo y contrase帽a
    • Alta de usuarios
    • Login de usuarios
    • Guards: Guardi谩n de navegaci贸n
    • Logout
    • Database: Cloud Firestore 鈥 Guardar nuestros sitios en la nube
    • Obtener listado de sitios de firestore.
  • Apache Cordova
    • A帽adiendo plataformas
    • Ejecutando nuestra app en el dispositivo m贸vil
    • Ionic Native
    • Preparar la app para la publicaci贸n usando cordova
    • Generar el splash screen y los iconos
    • Configurando nuestra app: Modificando el archivo config.xml
    • Evitar rotaci贸n de pantalla
    • Firmar el apk para subirlo a Google Play
  • Generar una PWA (Aplicaci贸n Web Progresiva)
    • 驴Que es una PWA?
    • Creando un hola mundo de ejemplo
    • Configurar la PWA
    • Preparar la aplicaci贸n para el entorno de producci贸n
    • Alojar nuestra aplicaci贸n en Firebase Hosting:
  • Ahora te toca a t铆

Si te ha gustado el contenido sobre ionic que he compartido en este blog y quieres tenerlo m谩s completo y mejor organizado y de paso apoyarme ya puedes comprar este libro en amazon:

Lo puedes encontrar en versi贸n tapa blanda:

https://www.amazon.es/dp/1700622722

Tambi茅n est谩 disponible en Kindle:

 

No quiero aburriros m谩s as铆 que muchas gracias a todos los que me hab茅is apoyado 馃檪

Un saludo y hasta el pr贸ximo post.

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso:

Tutorial de Ionic – Mini Juego de acertar n煤meros en ionic 2, el controlador de la p谩gina y Data Binding y *ngIF

En el siguiente enlace tienes el 铆ndice para acceder al resto de entradas de este tutorial:

 

隆隆Atenci贸n!! este tutorial se basa en ionic 3 y est谩 desactualizado por lo que es posible que los ejemplos no funcionen en la 煤ltima versi贸n de ionic, haz click aqu铆 para acceder a un tutorial mas actual de Ionic.

Hola a todos:

Despu茅s de ver en el capitulo anterior c贸mo modificar la plantilla de una p谩gina para simplemente mostrar el texto “Hola Mundo”, hoy vamos a avanzar un poco m谩s en nuestro aprendizaje聽y vamos a programar nuestra primera aplicaci贸n interactiva.

Se trata de un simple juego de acertar el n煤mero secreto. La aplicaci贸n crear谩 un n煤mero aleatorio que nosotros debemos adivinar.

Por primera vez vamos a programar con ionic 2. Por el camino aprenderemos conceptos como Data Binding, que nos permite actualizar valores entre el html y el controlador y recoger las acciones del usuario como 聽pulsar un bot贸n.

Bien, sin m谩s pre谩mbulos聽 vamos a empezar:

Vamos a crear un nuevo proyecto ionic 2 que en este caso le vamos a llamar adivina: abrimos el terminal o consola de comandos y escribimos:

ionic start adivina blank

Nos situamos dentro de la carpeta del proyecto de acabamos de crear:

cd adivina

Y una vez dentro ejecutamos ionic serve para ver en el navegador los cambios que vayamos haciendo en nuestra aplicaci贸n.

ionic serve

Recuerda que si utilizas la opci贸n -l con ionic serve puede visualizar como queda la app en todas las plataformas.

Ahora abrimos la carpeta del proyecto que acabamos de crear en el editor, entramos en src/pages/home y abrimos el archivo home.html.

Editamos su contenido para que quede de la siguiente manera:

<ion-header>
  <ion-navbar>
    <ion-title>
      Adivina el n煤mero secreto
    </ion-title>
  </ion-navbar>
</ion-header>
<ion-content padding>
    <ion-input type="number" min="1" max="100" [(ngModel)]="num" placeholder="Introduce un n煤mero del 1 al 100"></ion-input>
    <p>El n煤mero secreto es {{ mayorMenor }}</p>
   <button ion-button block (click)="compruebaNumero()">Adivina</button>
</ion-content>

Si nunca antes has programado en angular ni en ionic es posible que el c贸digo te resulte extra帽o, no te preocupes, ahora vamos a ver lo que es cada cosa, si por el contrario ya has programado en angular o ionic 1 es probable este c贸digo te resulte familiar.

Tenemos una plantilla b谩sica de una p谩gina con ion-header, ion-navbar y ion-title donde hemos puesto el t铆tulo de nuestra aplicaci贸n “Adivina el n煤mero secreto”. Hasta aqu铆 ninguna novedad con lo que ya hab铆amos visto en el cap铆tulo anterior.

Dentro de ion-content que como sabemos es donde va el contenido de la p谩gina es donde est谩 lo interesante:

 <ion-input type="number" min="1" max="100" [(ngModel)]="num" placeholder="Introduce un n煤mero del 1 al 100"></ion-input>

Primero tenemos un ion-input聽que es muy parecido a un input de html, le decimos que sea de tipo number, le ponemos un聽rango m铆nimo a 1 y m谩ximo a 100.

El siguiente par谩metro [(ngModel)]聽es el encargado de hacer el Data Binding entre el valor del input y una variable llamada num que estar谩 definida como luego veremos en el controlador de la p谩gina. Este es un Data Binding bidireccional ya que si se introduce un valor en el input autom谩ticamente este ser谩 reflejado en la variable del controlador, del mismo modo si alg煤n proceso cambia el valor de esta variable en el controlador este autom谩ticamente aparecer谩 reflejado como valor del input. Por 煤ltimo el input tiene un placeholder indicando que se introduzca un valor entre 1 y 100.

La siguiente l铆nea es un p谩rrafo que contiene lo siguiente:

<p>El n煤mero secreto es {{ mayorMenor }}</p>

Si ya conoces ionic o angular sabes de que se trata. En este caso las con las dobles llaves “{{ }}” 聽hacemos un Data Binding unidireccional, mayorMenor es una variable que estar谩 definida en el controlador y con las dobles llaves muestra su valor. En este caso la variable contendr谩 el texto “mayor” en caso de que el n煤mero secreto sea mayor al introducido, “menor” en caso de ser menor e “igual” en caso de ser igual.

Por 煤ltimo tenemos un bot贸n para comprobar si el n煤mero introducido coincide con el n煤mero secreto.

<button ion-button block (click)="compruebaNumero()">Adivina</button>

En la documentaci贸n oficial de ionic pod茅is ver m谩s sobre como crear distintos tipos de botones con ionic 2:聽https://ionicframework.com/docs/v2/components/#buttons

De momento esto es todo lo que necesitamos en la plantilla de nuestro juego.

Ahora necesitamos programar el comportamiento en el controlador de la p谩gina.

Si abrimos el archivo home.ts que se genera autom谩ticamente al crear un proyecto en blanco veremos el siguiente c贸digo:

import { Component } from '@angular/core';

import { NavController } from 'ionic-angular';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  constructor(public navCtrl: NavController) {

  }

}

Este c贸digo esta es typeScript. Como ya hemos comentado TypeScript permite utilizar elementos de las 煤ltimas versiones del est谩ndar ECMAscript aunque todav铆a no est茅n implementadas en el navegador que estemos utilizando. Tambi茅n nos permite utilizar variables tipadas.

Ionic 2 se basa Angular 2 que a su ver utiliza TypeScript, as铆 que es muy beneficioso conocer angular 2 y typescript.
Aqu铆 vamos a explicar a groso modo las cuestiones imprescindibles para poder desenvolvernos con ionic 2 pero para saber m谩s sobre angular y sacarle el m谩ximo partido pod茅is consultar en聽http://learnangular2.com/聽聽as铆 como otros muchos recursos que se pueden encontrar en la red para aprender Angular 2.

Analicemos el c贸digo de home.ts:

Lo primero que vemos son dos lineas import:

import { Component } from '@angular/core';

import { NavController } from 'ionic-angular';

Import se utiliza para importar m贸dulos que contienen librer铆as y clases para poder utilizarlas en nuestro proyecto. Podemos importar聽m贸dulos propios de Ionic que ya se incorporan al crear un proyecto, librer铆as de AngularJS, librer铆as de terceros que podemos instalar o nuestras propias 聽librer铆as.

En este caso se importa el elemento Component de Angular y el elemento NavController de ionic-angular.

NavController lo utilizaremos m谩s adelante para poder navegar entre distintas p谩ginas, de momento en este ejemplo no lo necesitamos.

Las p谩ginas son componentes de Angular, por eso necesitamos importar Component.

Despu茅s vemos el siguiente c贸digo:

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})

@Component es un decorador de Angular.聽Angular 2 usa los decoradores para registrar un componente.

Los decoradores empiezan con @.

Los decoradores se colocan antes de la clase y definen c贸mo se va a comportar esta.

Existen los siguientes 聽decoradores:

  • @Component
  • @Injectable
  • @Pipe
  • @Directive

De momento nos interesa @Component.

En el c贸digo vemos que @Component contiene un objeto con dos atributos, selector:’page-home’, que es el selector css que se va a aplicar a la p谩gina, y templateUrl:’home.html’聽que es la plantilla html que va a renderizar la p谩gina.

Por 煤ltimo se exporta una clase llamada HomePage:

export class HomePage {

  constructor(public navCtrl: NavController) {

  }

}

Tenemos que exportar la clase para luego poderla importar si queremos llamar a 聽la p谩gina desde cualquier otro sitio de la aplicaci贸n, por ejemplo cuando navegamos entre p谩ginas.
Vemos que la clase tiene un constructor, en TypeScript la creaci贸n de clases es muy similar a como ser铆a en otros lenguajes de programaci贸n orientado a objetos como Java.

Todos los datos que se muestran en la plantilla y todas las funciones a las que se llame por ejemplo al hacer click en un bot贸n deben formar parte de la clase HomePage qu茅 es el controlador de la p谩gina.

Como ya hemos visto en la plantilla home.html utilizamos聽(ngModel)]=”num”聽para recoger en la variable num el valor que se introduzca en el campo input, tambi茅n mostr谩bamos otra variable llamada聽mayorMenor que indicar谩 聽si el n煤mero introducido es mayor o menor que el n煤mero que hay que adivinar:

 <ion-input type="number" min="1" max="100"[(ngModel)]="num" placeholder="Introduce un n煤mero del 1 al 100"></ion-input>
    <p>El n煤mero secreto es {{ mayorMenor }}</p>

Por lo tanto estas variables deben de estar definidas en el controlador dentro de la clase HomePage del archivo home.ts:

export class HomePage {

聽 num:number;
聽 mayorMenor: string = '...';

  constructor(public navCtrl: NavController) {

  }

}

Como podemos observar para definir una variable ponemos el nombre de la variable y seguido de dos puntos “:”聽el tipo de valor que va a contener. Si lo deseamos podemos inicializar la variable con un valor en el momento de declararla. En este caso num es de tipo number y mayorMenor de tipo string ya que va a contener un texto con la palabra “Mayor”, “Menor” o “Igual” seg煤n sea el caso. Inicializamos la variable mayorMenor con tres puntos suspensivos “…”.

Los tipos primitivos 聽de variable que podemos definir son:

  • number (Num茅rico).
  • string (cadenas de texto).
  • boolean (Booleano: true o false).
  • any (cualquier tipo).
  • Array.

Tambi茅n vamos a necesitar otra variable que contenga el n煤mero secreto que debemos adivinar, le vamos a llamar numSecret y como valor le vamos a asignar la respuesta a la llamada a una funci贸n llamada numAleatorio que crearemos a continuaci贸n.

Definimos la variable numSecret de tipo number:

numSecret: number = this.numAleatorio(0,100);

Hacemos referencia a la 聽funci贸n numAleatorio con this porque va a ser un m茅todo de la propia clase.

Ahora vamos a 聽crear la funci贸n numAleatorio que nos devolver谩 un n煤mero aleatorio.

numAleatorio(a,b)
{
      return Math.round(Math.random()*(b-a)+parseInt(a));
}

Esta funci贸n recibe como par谩metros dos valores que ser谩n el rango m铆nimo y el m谩ximo para el n煤mero aleatorio, es este caso le estamos pasando 0 y 100 por lo que obtendremos un n煤mero aleatorio entre 0 y 100.

Por 煤ltimo vamos a crear la funci贸n compruebaNumero que se llama al pulsar el bot贸n Adivina聽que en la parte html lo hemos definido as铆:

<button ion-button block (click)="compruebaNumero()">Adivina</button>

Y ahora en home.ts definimos la funci贸n dentro de la clase HomePage:

compruebaNumero(){
    if(this.num)
    {
      if(this.numSecret < this.num)
      {
        this.mayorMenor = 'menor';
      }
      else if(this.numSecret > this.num)
      {
        this.mayorMenor = 'mayor';
      }
      else{
        this.mayorMenor = 'igual';
      }
    }
  }

Esta funci贸n compara聽el n煤mero secreto que esta contenido en la variable numSecret con聽el n煤mero introducido por el usuario que se aloja en la variable num y le asigna a la variable mayorMenor el texto “menor”, “mayor” o “igual” en funci贸n de si es menor, mayor o igual que esta.
Observa que debemos utilizar this para las variables ya que son atributos de la propia clase.

El c贸digo completo de home.ts quedar谩 de esta manera:

import { Component } from '@angular/core';

import { NavController } from 'ionic-angular';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  num:number;
  mayorMenor: string = '...';
  numSecret: number = this.numAleatorio(0,100);

  constructor(public navCtrl: NavController) {

  }

  compruebaNumero(){
    if(this.num)
    {
      if(this.numSecret < this.num)
      {
        this.mayorMenor = 'menor';
      }
      else if(this.numSecret > this.num)
      {
        this.mayorMenor = 'mayor';
      }
      else{
        this.mayorMenor = 'igual';
      }
    }
  }

  numAleatorio(a,b)
  {
        return Math.round(Math.random()*(b-a)+parseInt(a));
  }

}

Ahora si lo ejecutamos en el navegador con ionic serve聽(si no lo ten铆as ya en marcha), podemos ver un campo para introducir un n煤mero, y debajo un texto que dice “el n煤mero secreto es … de”, en estos momentos 聽no hay introducido ning煤n n煤mero por lo que no aparece ning煤n n煤mero en el texto.

Si introducimos un n煤mero vemos que autom谩ticamente en el texto aparece ese n煤mero el mismo tiempo que lo escribimos. Eso es porque estamos realizando un Data Binding con la variable num. Al utilizar [(ngModel)]=”num” en el campo input le estamos indicando que la variable coja el valor que introducimos en el input y lo refresque autom谩ticamente en todos los sitios donde se utilice, por ejemplo en el texto de debajo.Lo mismo ocurre si cambiamos el valor de la variable desde el c贸digo.

Por 煤ltimos si pulsamos el bot贸n adivina obtendremos algo como esto:

Vista de nuestro Juego en acci贸n
Vista de nuestro Juego en acci贸n

Al pulsar el bot贸n se ha ejecutado la funci贸n聽compruebaNumero(), dentro de la funci贸n se ha comprobado que el n煤mero secreto es mayor a 12 por lo que a la variable mayorMenor se le asigna el texto “mayor”.

Cuando acertemos el n煤mero secreto el texto dir谩 que el n煤mero secreto es igual al n煤mero introducido. Esto es un poco soso, vamos a hacer algunos cambios para que cuando acertemos el n煤mero nos muestre un mensaje felicit谩ndonos por haber acertado.

Este mensaje lo ponemos en la plantilla html pero solo se debe mostrar cuando se cumpla una condici贸n y es que la variable mayorMenor聽contenga el texto ‘igual’.

Vamos a a帽adir lo siguiente en home.html justo antes del bot贸n “Adivina”:

<ion-card *ngIf="mayorMenor=='igual'">
     <ion-card-header>
        隆隆隆Enhorabuena!!!
      </ion-card-header>
      <ion-card-content>
          Has acertado, el n煤mero secreto es el {{ num }}
      </ion-card-content>
</ion-card>

Aprovecho la ocasi贸n para introducir otro componente de ionic: ion-card, las cards o “tarjetas” son componentes que muestran la informaci贸n en un recuadro. Como vemos dentro contiene otros dos componentes <ion-card-header> y <ion-card-content>,聽Como habr谩s adivinado el primero permite mostrar una cabecera dentro de la tarjeta y el segundo el contenido que deseemos.
En la documentaci贸n oficial de ionic pod茅is ver todas las posibilidades que tiene ion-card:聽https://ionicframework.com/docs/v2/components/#cards

Queremos que est谩 card se muestre solo cuando la variable de nuestro controlador mayorMenor聽contenga el texto ‘igual’ despu茅s de hacer la comprobaci贸n.

Aqu铆 entra en juego la directiva condicional *ngIf:

<ion-card *ngIf="mayorMenor=='igual'">

La directiva *ngIf es una directiva estructural, lo que significa que nos permite alterar el DOM (Document Object Model), estas directivas llevan un asterisco “*” delante.
Con *ngIf le estamos indicando que el elemento donde se encuentra, ion-card en este caso, solo se muestre si se cumple la condici贸n que tiene definida entre las dobles comillas. En este caso le estamos diciendo que solo se muestre el elemento ion-card cuando mayorMenor==’igual’.

Sabiendo esto vamos a darle otra vuelta de tuerca m谩s y vamos a a帽adir un bot贸n para volver a jugar una vez que hemos acertado, este bot贸n llamar谩 a una funci贸n para volver a generar un nuevo n煤mero aleatorio y reiniciar谩 las variables para que se oculte el ion-card. Este bot贸n debe permanecer oculto hasta que hayamos acertado, y cuando se muestra debe ocultarse el bot贸n Adivina para que no podamos pulsarlo despu茅s de haber adivinado el n煤mero hasta que empecemos una nueva partida.

Editamos home.html y a帽adimos *ngIf al bot贸n Adivina para que solo se 聽muestre cuando no hemos acertado el n煤mero:

<button *ngIf="mayorMenor!='igual'" ion-button block (click)="compruebaNumero()">Adivina</button>

Ahora a帽adimos el bot贸n “Volver a Jugar” a home.html:

<button *ngIf="mayorMenor=='igual'" ion-button block (click)="reinicia()">Volver a Jugar</button>

Con *ngIf indicamos que solo se muestre cuando hayamos acertado el n煤mero, y en el evento (click) le indicamos que ejecute la funci贸n reinicia().

Por lo tanto ahora 聽vamos a editar nuestro controlador (home.ts) y a帽adimos la funci贸n reinicia(), que como hemos dicho debe reiniciar las variables para poder comenzar el juego:

reinicia(){
    // reiniciamos las variables
    this.num = null;
    this.mayorMenor = '...';
    this.numSecret = this.numAleatorio(0,100);
  }

Ahora ya podemos volver a jugar una vez de que hemos adivinado el n煤mero.

Este juego se podr铆a mejorar a帽adiendo un contador de intentos. Podr铆amos limitar el n煤mero de intentos y mostrar un mensaje si se han consumido todos los intentos sin acertar el n煤mero secreto. Esto lo dejo como deberes para el que quiera practicar m谩s, si quer茅is ver como ser铆a la soluci贸n completa con contador de intentosLuis Jord谩n聽me ha hecho llegar su soluci贸n, en el siguiente enlace pod茅is encontrar el c贸digo de la p谩gina home que ha mejorado realizado Luis:聽https://drive.google.com/file/d/0B7M15FxlLmQJZHBSTUlfMmFkSmM/view?usp=sharing

De momento este simple ejemplo nos ha servido para aprender algunos conceptos b谩sicos sobre Ionic 2, en el siguiente capitulo veremos como navegar entre distintas p谩ginas de una aplicaci贸n.

 

Si necesitas desarrollar una aplicaci贸n m贸vil no dudes en solicitarme un presupuesto sin compromiso: