Ionic 2 Split Pane for large screens and Desktop

  • Author: Ahmed Bouchefra

Today 08 March 2017 ,Ionic 2.2.0 is released with many features between them the new component Split Pane , which allows Ionic 2 developers to build user interfaces with two split views for devices with large screens such as tablets or Desktop .

The Ionic team is working to make Ionic 2 a framework for building user interfaces for Desktop environments and not just tablets and mobile phones by adding the Split Pane which is a very requested UI component on Desktop apps .

If you are already familiar with Ionic 2 but you have never used it for building user interfaces for Desktop apps you may be wondering ,Isn't Ionic 2 a hybrid mobile framework ,so how can we use it for Desktop apps ?

Yes ,Ionic 2 is a hybrid mobile framework based on Angular 2 .It is actually a bunch of UI components built using HTML ,CSS and JavaScript on top of Apache Cordova which is really the actual container that does the heavy job of interfacing with mobile device native features and allow you to actually build a mobile app with web technologies . So now how can you build Desktop apps with Ionic 2 ?

Just like Cordova ,there is another great container but this time for Desktop environments (Windows ,Linux and MAC) which allows you to wrap JavaScript apps into a native like Desktop application .The project is Electron ,built by GitHub .

There are many other projects similar to Electron ,the most popular is NW.js by Intel which follows another approach but allows you also to build cross platform Desktop apps with web technologies .

You can use either Electron or nw.js to wrap your Ionic 2 app into a Desktop application .For the sake of this tutorial ,i'm going to use Electron to show how to build a Desktop app with Ionic 2 and the Split Pane component

Getting Electron

We need to create an Electron app so we are going to use Github quick start project to quickly scaffold a new app .

Open your terminal/command prompt and execute

 git clone electron-ionic2-starter
 cd electron-ionic2-starter 
 npm install 
 npm start

You will be presented with a blank Electron project based on Electron 1.6 (when writing this tutorial ) ,next we need to integrate with Ionic 2 .You don't need to do any complex configuration .You just need to install Ionic .Scaffold your Ionic 2 app ,build it and then point Electron to the location of Ionic 2 web files

Installing Ionic 2

Now we proceed to install Ionic 2 .You don't need to install Cordova or any SDKs (For Android or iOS) ,because what we need is the UI components of Ionic 2 which are just Angular 2 + CSS + HTML ,since we are using Ionic 2 as a UI interface library for our Electron Desktop app

So go ahead and install Ionic CLI using your terminal or command prompt

npm install -g ionic 

Next ,let is use the Ionic CLI to scaffold a new blank Ionic 2 app inside our Electron app folder .

ionic start blank  app --v2    

We named our Ionic 2 project 'app' .feel free to change to a more elegant name

Now lets hook the two apps .

Open your Electron project main.js file then look for the create window function

mainWindow = new BrowserWindow({width: 800, height: 600})

// and load the index.html of the app.
    pathname: path.join(__dirname, 'app/www/index.html'),
    protocol: 'file:',
    slashes: true

After building (ionic serve) your Ionic 2 project .App files will live under the www folder .

So now before we continue we need to execute

ionic serve 

Inside our Ionic 2 project

Then run our Electron app with

npm start 

You should see your Ionic 2 app with default template running inside Electron .

Adding the Splite Pane

Open src/pages/home/home.html file ,delete everything and copy this code which adds a split pane with a menu at left .

<!--  our side menu  -->
<ion-menu [content]="content">
        <ion-item (click)="openMain()" >Main</ion-item>
        <ion-item  (click)="openAbout()">About</ion-item>            

<!-- the main content -->
<ion-nav [root]="rootPage" main #content></ion-nav>

So we have added an ion-split-pane with an ion-menu which creates a menu at left and ion-nav at right . Next we will add code to change the content of ion-nav when we click buttons on the menu .

You should pay attention to some details on the ion-nav and ion-menu components which are

  • root : which is binded to rootPage variable that defines the page that will be presented
  • main : you should add this attribute to tell ion-split-pane where the main content lives
  • #content : which specifies the target of menu actions

In src/pages/home.ts we should initialize rootPage variable with an initial value (a page )

So first we need to generate new pages with

ionic g page main 
ionic g page about 

Then open src/app/app.module.ts file and make sure to import and add any page you have created to module declarations and entryComponents lists .

import { NgModule, ErrorHandler } from '@angular/core';
import { IonicApp, IonicModule, IonicErrorHandler } from 'ionic-angular';
import { MyApp } from './app.component';
import { HomePage } from '../pages/home/home';
import { MainPage } from '../pages/main/main';
import { AboutPage } from '../pages/about/about';

declarations: [
imports: [
bootstrap: [IonicApp],
entryComponents: [
providers: [{provide: ErrorHandler, useClass: IonicErrorHandler}]
export class AppModule {}

Next open src/pages/home/home.ts then copy this code

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

import { NavController } from 'ionic-angular';

import { MainPage } from  '../main/main';
import { AboutPage } from  '../about/about';

selector: 'page-home',
templateUrl: 'home.html'
export class HomePage {
    rootPage :any = MainPage ;
    constructor(public navCtrl: NavController) {

        this.rootPage = MainPage ;
        this.rootPage = AboutPage ;


You can now build your app with :

ionic serve 

And then run electron with

npm start 

To test your app .

You can see the code accompanying this tutorial on GitHub


In this tutorial we have seen how to use the new Split Pane component of Ionic 2 to build the user interface Desktop app based on Electron .See your on the next tutorial with a close tutorial about Ionic 2 grids .

Sponsored Links