Tomislav Stanković, Autor na Tomislav Stanković

Ionic 2 – Dodavanje vanjskih skripti

Ionic 2 omogućava dodavanje široke palete Ionic Native pluginova koji mobilnoj aplikaciji daju mogućnost korištenja nativnih funkcionalnosti mobilnog uređaja. Inače, od nedavno se promijenio način korištenja Ionic Native pluginova.

Ipak, doći će vrijeme kada vam niti to neće biti dovoljno kako bi postigli sve ono što ste zamislili sa svojom Ionic 2 aplikacijom. Tu uskaču vanjske skripte kao što su npr. Chart.js i Moment.js, a kako njih dodati u Ionic 2 projekt možete saznati u nastavku.

Korištenje NPM-a

Pokretanjem NPM naredbe kao što je npr. $ npm install moment --save dodajete vanjsku skriptu u Ionic 2 projekt. U ovom primjeru dodat ćemo podršku za Moment.js.

Nakon što smo instalirali željenu skriptu potrebno je reći Ionic 2 aplikaciji da je ona aktivna i da ju želimo koristiti. To činimo na način da uvezemo željenu skriptu import moment from 'moment'; na vrhu komponente u kojoj tu skriptu želimo koristiti.

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

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

  obican_datum: any;
  moment_datum: any;

  constructor(public _navCtrl: NavController) {
    
    this.obican_datum = new(Date);
    console.log(this.obican_datum);

    this.moment_datum = moment(this.obican_datum).format('LL');
    console.log(this.moment_datum);

  }

}

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

import { NavController } from 'ionic-angular';

import moment from 'moment';

@Component({

selector: 'page-home',

templateUrl: 'home.html'

})

export class HomePage {

obican_datum: any;

moment_datum: any;

constructor(public _navCtrl: NavController) {

this.obican_datum = new(Date);

console.log(this.obican_datum);

this.moment_datum = moment(this.obican_datum).format('LL');

console.log(this.moment_datum);

}

Na prednjoj strani to izgleda ovako:

<ion-header>
  <ion-navbar>
    <ion-title>
      Ionic 2 Aplikacija
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>

<p>Običan datum: {{obican_datum}}</p>
<p>Moment datum: {{moment_datum}}</p>

</ion-content>

<ion-header>

<ion-navbar>

<ion-title>

Ionic 2 Aplikacija

</ion-title>

</ion-navbar>

</ion-header>

<ion-content padding>

<p>Običan datum: {{obican_datum}}</p>

<p>Moment datum: {{moment_datum}}</p>

</ion-content>

Korištenje script taga

U ovom primjeru dodat ćemo Google Maps API.

U index.html dodajemo poveznicu na skriptu koju želimo koristiti.

<body>

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

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap" async defer></script>

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

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

</body>

<body>

<ion-app></ion-app>

</body>

Osim toga, kako bi imali pristup globalnom objektu potrebno je instalirati pripadajući @types paket.

Tek sada u cijeloj aplikaciji imamo dostupan globalni objekt.

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

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

export class HomePage {

  constructor(public _navCtrl: NavController) {
    
   console.log(google);

  }

}

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

import { NavController } from 'ionic-angular';

@Component({

selector: 'page-home',

templateUrl: 'home.html'

})

export class HomePage {

constructor(public _navCtrl: NavController) {

console.log(google);

}

Zaključak

I to je to. Gore navedena dva načina dodavanja vanjskih skripti u Ionic 2 projekt ovise o mogućnostima svake pojedine skripte. Prije nego se odlučite za korištenje neke skripte provjerite koje sve načine dodavanja u Ionic 2 projekt nudi.

Ionic 2 – prosljeđivanje parametara između stranica

Kada se radi mobilna aplikacija pitanje je vremena kada će ona postati kompleksnija tj. imati više stranica između kojih će trebati postojati interaktivnost, a to podrazumijeva prosljeđivanje nekih parametara s jedne stranice na drugu.

Pod pretpostavkom da već imate pokrenut Ionic 2 projekt možemo krenuti dalje.

Kreiranje stranica

Za početak trebamo kreirati dvije stranice. Jedna će služiti za prikaz svih korisnika $ ionic g page korisnici, a druga za prikaz jednog korisnika $ ionic g page korisnik.

Servis za dohvaćanje korisnika

Naša aplikacija će komunicirati s dva API-ja. Jedan će dohvaćati popis svih korisnika koji će se prikazivati na korisnici.html stranici, a drugi će dohvaćati detalje jednog korisnika koji će se prikazivati na stranici korisnik.html.

Servis kreiramo naredbom $ ionic g provider Korisnici

Kao što se vidi iz dolje navedene funkcije dohvatiKorisnika() ona zahtjeva parametar a.id koji je zapravo ID jednog korisnika.

import { Injectable } from '@angular/core';
import { Http } from '@angular/http';
import 'rxjs/add/operator/map';

@Injectable()
export class KorisniciService {

  constructor(public _http: Http) {
    console.log('Korisnici Provider');
  }

   dohvatiKorisnike(a){
    return this._http.get('http://localhost:3001/api/korisnici' a)
                .map(res => res.json());
   } 

   dohvatiKorisnika(a: any){
    return this._http.post('http://localhost:3001/api/korisnik=' + a.id)
                .map(res => res.json());  
   }

}

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

import { Http } from '@angular/http';

import 'rxjs/add/operator/map';

@Injectable()

export class KorisniciService {

constructor(public _http: Http) {

console.log('Korisnici Provider');

}

dohvatiKorisnike(a){

return this._http.get('http://localhost:3001/api/korisnici' a)

.map(res => res.json());

}

dohvatiKorisnika(a: any){

return this._http.post('http://localhost:3001/api/korisnik=' + a.id)

.map(res => res.json());

}

Popis korisnika

Funkcija u 16. liniji prosljeđuje samo jedan parametar id koji nam je i potreban na sljedećoj stranici jer prema tom parametru ćemo aktivirati API za dohvaćanje jednog korisnika koji je vezan uz taj parametar tj. uz taj ID.

Funkcija u 18. liniji prosljeđuje čitav objekt koji smo u ovom slučaju nazvali test.

<ion-header>
  <ion-navbar color="primary">
    <button ion-button menuToggle>
      <ion-icon name="menu"></ion-icon>
    </button>
    <ion-title>Korisnici</ion-title>
  </ion-navbar>
</ion-header>


<ion-content padding>

<ion-card *ngFor="let popis of popiskorisnika; let i=index">
  <ion-card-header>
  <!-- Prosljeđivanje "id" parametra -->
  <a (click)="korisnikPage({id:popis.id})">{{popis.username}}</a> 
  <!-- Prosljeđivanje "test" objekta --> 
  <a (click)="korisnikPage({test:popis})">{{popis.username}}</a>  
  </ion-card-header>
  <ion-card-content>
    <ul>
      <li>Username: {{popis.username}}</li>
      <li>Email: {{popis.email}}</li>
    </ul>
  </ion-card-content>
</ion-card>

</ion-content>

<ion-header>

<ion-navbar color="primary">

<ion-icon name="menu"></ion-icon>

</button>

<ion-title>Korisnici</ion-title>

</ion-navbar>

</ion-header>

<ion-content padding>

<ion-card *ngFor="let popis of popiskorisnika; let i=index">

<ion-card-header>

<a (click)="korisnikPage({id:popis.id})">{{popis.username}}</a>

<a (click)="korisnikPage({test:popis})">{{popis.username}}</a>

</ion-card-header>

<ion-card-content>

<ul>

<li>Username: {{popis.username}}</li>

<li>Email: {{popis.email}}</li>

</ul>

</ion-card-content>

</ion-card>

</ion-content>

U ovom kontroleru koristimo NavController ugrađenu Ionic 2 klasu za navigaciju između stranica.

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';
import { KorisniciService } from '../../providers/korisnici';
import { KorisnikPage } from './korisnik';

@Component({
  selector: 'korisnici-page',
  providers: [KorisniciService],
  templateUrl: 'korisnici.html'
})
export class KorisniciPage {

  popiskorisnika:any;
  a:any;

  constructor(public navCtrl: NavController, public _korisnici: KorisniciService) {

     this._korisnici.dohvatiKorisnike(this.a).subscribe(res => {
       this.popiskorisnika = res.popis_korisnika;
  });

  }

  ionViewDidLoad() {
    console.log('KorisniciPage');
  }

   korisnikPage(popiskorisnika){
    this.navCtrl.push(KorisnikPage, popiskorisnika);
  }

}

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

import { NavController } from 'ionic-angular';

import { KorisniciService } from '../../providers/korisnici';

import { KorisnikPage } from './korisnik';

@Component({

selector: 'korisnici-page',

providers: [KorisniciService],

templateUrl: 'korisnici.html'

})

export class KorisniciPage {

popiskorisnika:any;

a:any;

constructor(public navCtrl: NavController, public _korisnici: KorisniciService) {

this._korisnici.dohvatiKorisnike(this.a).subscribe(res => {

this.popiskorisnika = res.popis_korisnika;

});

}

ionViewDidLoad() {

console.log('KorisniciPage');

}

korisnikPage(popiskorisnika){

this.navCtrl.push(KorisnikPage, popiskorisnika);

}

Jedan korisnik

U ovom kontroleru također koristimo NavController ugrađenu Ionic 2 klasu za navigaciju između stranica. Ipak, ovdje nam još treba i NavParams za dohvaćanje prosljeđenih parametara.

import { Component } from '@angular/core';
import { NavController, NavParams } from 'ionic-angular';
import { KorisniciService } from '../../providers/korisnici';

@Component({
  selector: 'page-korisnik',
  providers: [KorisniciService],
  templateUrl: 'korisnik.html'
})
export class KorisnikPage {

  popiskorisnika:any;
  id:number;

  constructor(public navCtrl: NavController, public _korisnici: KorisniciService, public _navParams: NavParams) {

    // Objekt od "test" parametra
    this.test = _navParams.data;
    console.log(this.test);

    // "ID" parametar
    this._navParams.get('id');
    console.log(this._navParams.get('id'));

    // "ID" parametar
    this.id = _navParams.get('id');
    console.log(this.id); 

     this._korisnici.dohvatiKorisnika(this.id).subscribe(res => {
       this.korisnik = res.jedan_korisnik;
  }); 

  }

  ionViewDidLoad() {
    console.log('KorisnikPage');
  }

}

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

import { NavController, NavParams } from 'ionic-angular';

import { KorisniciService } from '../../providers/korisnici';

@Component({

selector: 'page-korisnik',

providers: [KorisniciService],

templateUrl: 'korisnik.html'

})

export class KorisnikPage {

popiskorisnika:any;

id:number;

constructor(public navCtrl: NavController, public _korisnici: KorisniciService, public _navParams: NavParams) {

// Objekt od "test" parametra

this.test = _navParams.data;

console.log(this.test);

// "ID" parametar

this._navParams.get('id');

console.log(this._navParams.get('id'));

// "ID" parametar

this.id = _navParams.get('id');

console.log(this.id);

this._korisnici.dohvatiKorisnika(this.id).subscribe(res => {

this.korisnik = res.jedan_korisnik;

});

}

ionViewDidLoad() {

console.log('KorisnikPage');

}

U slučaju kada smo kao parametar proslijedili čitav test objekt podatke ćemo prikazati na sljedeći način. Znači, prilikom učitavanja stranice ne trebamo pozivati nikakav drugi API jer smo si proslijedili potrebne podatke o korisniku koje možemo prikazati na ekranu.

<ion-card>
  <ion-card-header>
  <p> {{test.username}}</p>
  </ion-card-header>
  <ion-card-content>
    <ul>
      <li>{{test.email}}</li>
    </ul>
  </ion-card-content>
</ion-card>

<ion-card>

<ion-card-header>

<p> {{test.username}}</p>

</ion-card-header>

<ion-card-content>

<ul>

<li>{{test.email}}</li>

</ul>

</ion-card-content>

</ion-card>

Ali ako smo proslijedili samo parametar id pomoću kojega aktiviramo API za prikaz detalja jednog korisnika tada podatke prikazujemo na sljedeći način

<ion-card>
  <ion-card-header>
  <p> {{korisnik.username}}</p>
  </ion-card-header>
  <ion-card-content>
    <ul>
      <li>{{korisnik.email}}</li>
    </ul>
  </ion-card-content>
</ion-card>

<ion-card>

<ion-card-header>

<p> {{korisnik.username}}</p>

</ion-card-header>

<ion-card-content>

<ul>

<li>{{korisnik.email}}</li>

</ul>

</ion-card-content>

</ion-card>

Zaključak

I to je to. Ovo su osnove koje se tiču prosljeđivanja parametara između stranica u Ionic 2 aplikaciji. Sve dalje ovisi o specifičnim potrebama svake Ionic 2 aplikacije.

Ionic 2 – Events, upravljanje događajima

Prije ili kasnije susrest ćete se s potrebom pokretanja nekog događaja (event) u jednoj komponenti i dohvaćanja tog događaja u drugoj komponenti kao što se dogodilo ovom StackOverflow korisniku, a koji me i potaknuo na objavu ovog blog posta.

Ionic 2 koristi Events API koji omogućava objavu nekog događaja i mogućnost pretplate na taj događaj na razini aplikacije tj. u bilo kojoj drugoj komponenti. Događaj može biti varijabla, objekt ili nekakva funkcija. Ovisi što vam treba.

Recimo da je jedan od scenarija kada se korisnik prijavi u aplikaciju i otvori izbornik (sidemenu) da odmah vidi svoje korisničko ime, sliku i npr. email. S obzirom da se prijava u aplikaciju vrši u jednoj komponenti login.ts, a logika izbornika se nalazi u drugoj komponenti app.component.ts potrebno je nekako omogućiti da komponenta 2 osluškuje što se događa u komponenti 1 i da reagira prema tome.

Kako koristiti Ionic 2 Events?

U nastavku možete vidjeti primjer iz službene Ionic 2 dokumentacije.

import { Events } from 'ionic-angular';

constructor(public events: Events) {}

// first page (publish an event when a user is created)
function createUser(user) {
  console.log('User created!')
  events.publish('user:created', user, Date.now());
}

// second page (listen for the user created event)
events.subscribe('user:created', (user, time) => {
  // user and time are the same arguments passed in `events.publish(user, time)`
  console.log('Welcome', user, 'at', time);
});

import { Events } from 'ionic-angular';

constructor(public events: Events) {}

// first page (publish an event when a user is created)

function createUser(user) {

console.log('User created!')

events.publish('user:created', user, Date.now());

}

// second page (listen for the user created event)

events.subscribe('user:created', (user, time) => {

// user and time are the same arguments passed in `events.publish(user, time)`

console.log('Welcome', user, 'at', time);

});

Jedino što trebamo napraviti kako bi mogli koristiti Ionic 2 Events je u obje komponente uvesti import { Events } from 'ionic-angular';. Znači, nije potrebna instalacija nikakvog dodatka.

Za one koji žele znati više

Obradit ćemo scenarij u kojemu želimo prikazati korisničko ime i email u izborniku (sidemenu) od korisnika koji se upravo prijavio u mobilnu aplikaciju.

U login.ts vršimo prijavu korisnika i ovdje kreiramo događaj _events.subscribe.

import { Events } from 'ionic-angular';
constructor(public _events: Events) {
}

logIn() {
   localStorage.setItem('username', res.username);
   localStorage.setItem('email', res.email);
_events.publish('user:login');
}

import { Events } from 'ionic-angular';

constructor(public _events: Events) {

}

localStorage.setItem('username', res.username);

localStorage.setItem('email', res.email);

_events.publish('user:login');

}

U app.component.ts se pretplaćujemo _events.publish na taj događaj.

import { Events } from 'ionic-angular';

constructor(public _events: Events) {
_events.subscribe('user:login', () => {
  this.loggedIn();
});
}

loggedIn() {
   this.username = localStorage.getItem('username');
   this.email = localStorage.getItem('email');
}

import { Events } from 'ionic-angular';

constructor(public _events: Events) {

_events.subscribe('user:login', () => {

this.loggedIn();

});

}

loggedIn() {

this.username = localStorage.getItem('username');

this.email = localStorage.getItem('email');

}

Zaključak

I to je sve. Kratak blog post, ali zato vrlo koristan. Za više informacija posjetite službenu dokumentaciju.

Google Drive REST API & Ionic 2 – prikaz podataka

U ovom ćemo blog postu napraviti primjer Ionic 2 aplikacije koja prikazuje podatke izravno s Google Diska pomoću Google Drive REST API-ja.

Najveći fokus biti će na postavljanju Google Drive API-ja kako bi dobili URL, na koji ćemo slati GET zahtjev, koji se onda može koristiti u svim vrstama mobilnih i web aplikacija. Ovdje je sada slučajno ispalo da će se prikaz vršiti u Ionic 2 aplikaciji, ali isto tako mogli smo napraviti običnu Angular 2 web aplikaciju ili nešto treće.

Jedna od najvećih prednosti korištenja Google Drive API-ja je što ne morate raditi svoj API jer to ipak zahtjeva nešto više vremena i znanja kako bi se sve postavilo i bilo spremno za korištenje. U ovom slučaju Google se brine za sve, a na vama je samo da smislite način kako najbolje iskoristiti to što vam Google nudi unutar svoje web ili mobilne aplikacije.

Google API Manager

Na adresi https://console.developers.google.com/ ćemo kreirati aplikaciju za koju trebamo API key.

Nakon što smo to napravili trebamo odobriti (Enable) Google Drive API.

Sada moramo kreirati pristupne podatke (Credentials) kako bi Google znao da imamo pravo pristupiti podacima unutar Google Drivea.

U ovom slučaju mi ćemo koristiti API key. Više o ostalim vrstama autentifikacije možete saznati ovdje.

API key uspješno kreiran.

Nakon što je API key kreiran imamo mogućnost pozabaviti se njegovom sigurnošću. U ovom primjeru opciju sigurnosti ćemo ostaviti kao None jer će ovaj blog post dobiti značajno na dužini i kompleksnosti ako krenem sve opcije detaljno objašnjavati. Također, nakon objave ovog blog posta API koji smo kreirali ću ugasiti tako da neće biti sigurnosnih problema. Vi nipošto nemojte svoj Google Drive API ostaviti tako nezaštićen.

Google Drive API URL

Kako bi mogli prikazati podatke iz Google Drivea osim API keya trebamo i ID mape iz koje želimo vući podatke. Više o tome na API Reference.

https://www.googleapis.com/drive/v2/files?q='{folder ID}'+in+parents&key={API key}

1	https://www.googleapis.com/drive/v2/files?q='{folder ID}'+in+parents&key={API key}

Na Google Driveu sada imamo mapu ZaIonic2Aplikaciju unutar koje se nalaze još dvije mape, nekoliko fotografija i jedan Word dokument.

Iz URL-a https://drive.google.com/drive/folders/0BzVqFZUj1VDhYnk4dkZ1NGVRWUE ćemo izvući ID mape 0BzVqFZUj1VDhYnk4dkZ1NGVRWUE .

Sada još samo trebamo postaviti u opcijama naše mape da je vidljiva javno.

I konačno, naš API URL izgleda ovako https://www.googleapis.com/drive/v2/files?q='0BzVqFZUj1VDhYnk4dkZ1NGVRWUE'+in+parents&key=AIzaSyC6Ifro0MzucXPKM-LpKNB2M-dP6U1yPYU.

API sada možemo testirati koristeći Postman. Rezultat je array sa objektima.

Ionic 2 aplikacija

Ovako to izgleda kada se API koristi unutar Ionic 2 aplikacije. Kako to postići možete saznati u jednom od prethodnih blog postova pod nazivom “Ionic 2 – prikaz JSON-a sa API-ja“.

<ion-header>
  <ion-navbar>
    <ion-title>
     Google Drive API Data
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
  <button ion-button color="light" (click)="getData()">GET Data</button>
 
  <ion-card *ngFor="let u of data">

  <ion-item>
    <ion-avatar item-left>
      <img src="{{u.owners[0].picture.url}}">
    </ion-avatar>
    <h2>Naziv: {{u.title}}</h2>
    <p>Autor: {{u.owners[0].displayName}}</p>
	<p>Datum: {{u.createdDate}}</p>
  </ion-item>
  
   <img src="{{u.thumbnailLink}}"> 

</ion-card>
</ion-content>

<ion-header>

<ion-navbar>

<ion-title>

Google Drive API Data

</ion-title>

</ion-navbar>

</ion-header>

<ion-content padding>

<ion-card *ngFor="let u of data">

<ion-item>

<ion-avatar item-left>

</ion-avatar>

<h2>Naziv: {{u.title}}</h2>

<p>Autor: {{u.owners[0].displayName}}</p>

<p>Datum: {{u.createdDate}}</p>

</ion-item>

</ion-card>

</ion-content>

Pomoću parametra mimeType možemo si filtrirati npr. samo mape, fotografije i dr.

Zaključak

Kada radite aplikaciju u kojoj želite prikazati neke podatke jedna od mogućnosti je korištenje Google Drive API-ja. U ovom ste blog postu mogli vidjeti koliko je jednostavno postaviti funkcionalan API o kojemu kasnije ne morate previše brinuti za razliku od opcije da radite svoj NodeJS & ExpressJS API.

Ionic 2 – Podrška za višejezičnost

Kako raste važnost mobilne aplikacije tako se povećava i nužnost višejezičnosti. U ovom blog proći ćemo kroz postupak dodavanja podrške za višejezičnost korištenjem NG2-Translate plugina. Hrvatski jezik ćemo postaviti kao zadani dok će se uz njega moći odabrati još engleski i njemački jezik.

Uz pretpostavku da ste već pokrenuli novi Ionic 2 projekt možemo krenuti dalje.

Dodavanje NG2-Translate plugina

NG2-Translate plugin dodajemo pomoću naredbe

$ npm install ng2-translate --save

1	$ npm install ng2-translate --save

Nakon toga fokus prebacujemo na app.module.ts.

Kako bi uopće mogli koristiti NG2-Translate moramo ga uvesti u app.module.ts.

import { TranslateModule, TranslateStaticLoader, TranslateLoader} from 'ng2-translate/ng2-translate';
import { Http } from '@angular/http';

1 2	import { TranslateModule, TranslateStaticLoader, TranslateLoader} from 'ng2-translate/ng2-translate'; import { Http } from '@angular/http';

NG2-Translate kao zadano traži datoteke s prijevodom unutar mape i18n/ i tu ćemo mapu kreirati unutar src/assets.

export function createTranslateLoader(http: Http) {
	return new TranslateStaticLoader(http, './assets/i18n', '.json');
}

export function createTranslateLoader(http: Http) {

return new TranslateStaticLoader(http, './assets/i18n', '.json');

}

Naravno, sada trebamo kreirati i18n mapu.

Odmah nakon toga dodajemo ga i u NgModule niz.

imports: [
  IonicModule.forRoot(MyApp),
  TranslateModule.forRoot({
    provide: TranslateLoader,
    useFactory: (createTranslateLoader),
    deps: [Http]
  })
]

imports: [

IonicModule.forRoot(MyApp),

TranslateModule.forRoot({

provide: TranslateLoader,

useFactory: (createTranslateLoader),

deps: [Http]

})

]

Kreiranje .json datoteka

Za svaki jezik koji želimo omogućiti u Ionic 2 aplikaciji moramo napraviti posebnu .json datoteku. U ovom slučaju imamo tri .json datoteke.

hr.json za hrvatski
en.json za engleski
de.json za njemački

Datoteke izgledaju ovako:

hr.json

{
	"poruka": "Dobrodošli",
	"uvod" : "Uvod",
    "odjava" : "Odjava"
}

{

"poruka": "Dobrodošli",

"uvod" : "Uvod",

"odjava" : "Odjava"

}

en.json

{
	"poruka": "Welcome",
	"uvod" : "Introduction",
     "odjava" : "Log out"
}

{

"poruka": "Welcome",

"uvod" : "Introduction",

"odjava" : "Log out"

}

de.json

{
	"poruka": "Willkommen",
	"uvod" : "Einführung",
     "odjava" : "Ausloggen"
}

{

"poruka": "Willkommen",

"uvod" : "Einführung",

"odjava" : "Ausloggen"

}

Korištenje višejezičnosti

Odlučili smo da će zadani jezik biti hrvatski. Zato u app.component.ts dodajemo sljedeće:

import {TranslateService} from 'ng2-translate';

...

constructor(_platform: Platform,
            _translate: TranslateService) {}

 _platform.ready().then(() => {
    //Zadani jezik
       _translate.setDefaultLang('hr');
  });

import {TranslateService} from 'ng2-translate';

...

constructor(_platform: Platform,

_translate: TranslateService) {}

_platform.ready().then(() => {

//Zadani jezik

_translate.setDefaultLang('hr');

});

Prikaz prijevoda:

<ion-list inset>
   <ion-item>{{ 'poruka' | translate:param }}</ion-item>
   <ion-item>{{ 'uvod' | translate:param }}</ion-item>
   <ion-item>{{ 'odjava' | translate:param }}</ion-item>
</ion-list>

<ion-list inset>

<ion-item>{{ 'poruka' | translate:param }}</ion-item>

<ion-item>{{ 'uvod' | translate:param }}</ion-item>

<ion-item>{{ 'odjava' | translate:param }}</ion-item>

</ion-list>

Jezik koji postavimo na ovaj način automatski se učitava prilikom pokretanja Ionic 2 aplikacije.

Napredno korištenje višejezičnosti

Što kada želimo korisniku omogućiti da samostalno bira na kojem jeziku želi koristiti mobilnu aplikaciju?

U tom slučaju dodajemo tri funkcije

 translateCroatian(){
    this._translate.use('hr');
  }

   translateEnglish(){
    this._translate.use('en');
  }

   translateGerman(){
    this._translate.use('de');
  }

translateCroatian(){

this._translate.use('hr');

}

translateEnglish(){

this._translate.use('en');

}

translateGerman(){

this._translate.use('de');

}

i tri gumba pomoću kojih će korisnici moći odabrati koji jezik žele koristiti

<ion-row>
    <ion-col><button ion-button color="light" (click)="translateCroatian()">HR</button></ion-col>
    <ion-col><button ion-button color="light" (click)="translateEnglish()">EN</button></ion-col>
    <ion-col><button ion-button color="light" (click)="translateGerman()">DE</button></ion-col>
</ion-row>

<ion-row>

<ion-col><button ion-button color="light" (click)="translateCroatian()">HR</button></ion-col>

<ion-col><button ion-button color="light" (click)="translateEnglish()">EN</button></ion-col>

<ion-col><button ion-button color="light" (click)="translateGerman()">DE</button></ion-col>

</ion-row>

To izgleda ovako:

Međutim, ovdje imamo jedan problem. Korisnik može odabrati jezik koji želi koristiti u mobilnoj aplikaciji, ali taj jezik se vrati na zadani čim se ponovno učita/osvježi aplikacija.

Kako bi to riješili koristiti ćemo localStorage. Kada korisnik odabere jezik podatak o tome sprema se u lokalnu memoriju. Taj podatak ćemo kasnije koristiti kako bi znali je li korisnik odabrao jezik kako bi mu isti mogli prikazati. U konačnici to izgleda ovako:

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

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

  en:string;
  de:string;

  constructor(public _navCtrl: NavController,
              public _translate: TranslateService) {
  }

  translateCroatian(){
    this._translate.use('hr');
    //Brisanje EN ili DE iz lokalne memorije
    localStorage.removeItem('language');
  }

   translateEnglish(){
    this._translate.use('en');
    //Spremanje varijable u lokalnu memoriju
    this.en = "EN";
    localStorage.setItem('language',this.en);
  }

   translateGerman(){
    this._translate.use('de');
    //Spremanje varijable u lokalnu memoriju
    this.de = "DE";
    localStorage.setItem('language',this.de);
  }

}

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

import { NavController } from 'ionic-angular';

import {TranslateService} from 'ng2-translate';

@Component({

selector: 'page-home',

templateUrl: 'home.html'

})

export class HomePage {

en:string;

de:string;

constructor(public _navCtrl: NavController,

public _translate: TranslateService) {

}

translateCroatian(){

this._translate.use('hr');

//Brisanje EN ili DE iz lokalne memorije

localStorage.removeItem('language');

}

translateEnglish(){

this._translate.use('en');

//Spremanje varijable u lokalnu memoriju

this.en = "EN";

localStorage.setItem('language',this.en);

}

translateGerman(){

this._translate.use('de');

//Spremanje varijable u lokalnu memoriju

this.de = "DE";

localStorage.setItem('language',this.de);

}

Prilikom pokretanja aplikacije vršit ćemo provjeru odabranog jezika.

import { Component } from '@angular/core';
import { Platform } from 'ionic-angular';
import { StatusBar, Splashscreen } from 'ionic-native';

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

import {TranslateService} from 'ng2-translate';

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

  constructor(_platform: Platform,
              _translate: TranslateService) {
    _platform.ready().then(() => {

       //Zadani jezik
       _translate.setDefaultLang('hr');

      //Provjera jezika
      if(localStorage.getItem('language') === "EN"){
         _translate.use('en');
      } else if(localStorage.getItem('language') === "DE") {
         _translate.use('de');
      }

      StatusBar.styleDefault();
      Splashscreen.hide();
    });
  }
}

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

import { Platform } from 'ionic-angular';

import { StatusBar, Splashscreen } from 'ionic-native';

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

import {TranslateService} from 'ng2-translate';

@Component({

templateUrl: 'app.html'

})

export class MyApp {

rootPage = HomePage;

constructor(_platform: Platform,

_translate: TranslateService) {

_platform.ready().then(() => {

//Zadani jezik

_translate.setDefaultLang('hr');

//Provjera jezika

if(localStorage.getItem('language') === "EN"){

_translate.use('en');

} else if(localStorage.getItem('language') === "DE") {

_translate.use('de');

}

StatusBar.styleDefault();

Splashscreen.hide();

});

}

Ako u localStorage nemamo zapisano ništa prikazat će se zadani hrvatski jezik. Međutim, ako se u lokalnoj memoriji nalazi EN ili DE to znači da je korisnik kliknuo na gumb i da želi koristiti neki drugi jezik umjesto hrvatskog.

<ion-header>
  <ion-navbar>
    <ion-title>
      NG2-Translate
    </ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>

 <ion-row>
    <ion-col><button ion-button color="light" (click)="translateCroatian()">HR</button></ion-col>
    <ion-col><button ion-button color="light" (click)="translateEnglish()">EN</button></ion-col>
    <ion-col><button ion-button color="light" (click)="translateGerman()">DE</button></ion-col>
</ion-row>

<ion-list inset>
   <ion-item>{{ 'poruka' | translate:param }}</ion-item>
   <ion-item>{{ 'uvod' | translate:param }}</ion-item>
   <ion-item>{{ 'odjava' | translate:param }}</ion-item>
</ion-list>

</ion-content>

<ion-header>

<ion-navbar>

<ion-title>

NG2-Translate

</ion-title>

</ion-navbar>

</ion-header>

<ion-content padding>

<ion-row>

<ion-col><button ion-button color="light" (click)="translateCroatian()">HR</button></ion-col>

<ion-col><button ion-button color="light" (click)="translateEnglish()">EN</button></ion-col>

<ion-col><button ion-button color="light" (click)="translateGerman()">DE</button></ion-col>

</ion-row>

<ion-list inset>

<ion-item>{{ 'poruka' | translate:param }}</ion-item>

<ion-item>{{ 'uvod' | translate:param }}</ion-item>

<ion-item>{{ 'odjava' | translate:param }}</ion-item>

</ion-list>

</ion-content>

Jezik uređaja kao jezik aplikacije

Postoji još jedna opcija, a to je aplikacija bude automatski prevedena na jezik uređaja. Znači, ako korisnik ima kao jezik uređaja postavljen npr. hrvatski jezik onda će mu i aplikacija prilikom pokretanja biti automatski prikazana na hrvatskom jeziku tako da on neće morati raditi ručno pritiskom na gumb kao i primjeru iznad.

Kako bi se ovo omogućilo potrebno je instalirati Globalization plugin.

Nakon instalacije plugin se uveze u app.module.ts

import { Globalization } from '@ionic-native/globalization';

..

providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler},
    Globalization  
  ]

import { Globalization } from '@ionic-native/globalization';

providers: [

StatusBar,

SplashScreen,

{provide: ErrorHandler, useClass: IonicErrorHandler},

Globalization

]

I odmah se može koristiti.

Provjeru i postavljenja jezika postavit ćemo u app.component.ts

import { Component } from '@angular/core';
import { Platform } from 'ionic-angular';
import { StatusBar, Splashscreen } from 'ionic-native';
 
import { HomePage } from '../pages/home/home';
 
import { TranslateService } from 'ng2-translate';
import { Globalization } from '@ionic-native/globalization';
 
@Component({
  templateUrl: 'app.html'
})
export class MyApp {
  rootPage = HomePage;
 
  constructor(_platform: Platform,
              _translate: TranslateService,
              _globalization: Globalization) {
    _platform.ready().then(() => {
          StatusBar.styleDefault();
          Splashscreen.hide();
 
       //Zadani jezik
       _translate.setDefaultLang('hr');
 
       _globalization.getPreferredLanguage().then(result => {
          let deviceLng = result.value.substring(0,2).toLowerCase();
          _translate.use(deviceLng);
         })
    });
  }
}

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

import { Platform } from 'ionic-angular';

import { StatusBar, Splashscreen } from 'ionic-native';

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

import { TranslateService } from 'ng2-translate';

import { Globalization } from '@ionic-native/globalization';

@Component({

templateUrl: 'app.html'

})

export class MyApp {

rootPage = HomePage;

constructor(_platform: Platform,

_translate: TranslateService,

_globalization: Globalization) {

_platform.ready().then(() => {

StatusBar.styleDefault();

Splashscreen.hide();

//Zadani jezik

_translate.setDefaultLang('hr');

_globalization.getPreferredLanguage().then(result => {

let deviceLng = result.value.substring(0,2).toLowerCase();

_translate.use(deviceLng);

})

});

}

Zaključak

U ovom smo blog postu prikazali jedan od načina kako omogućiti višejezičnost u Ionic 2 aplikaciji. Naravno da postoji više različitih načina na koje je moguće koristiti višejezičnost i sve ranije navedeno može se prilagoditi specifičnim potrebama svake Ionic 2 aplikacije.