Repository  -  API  -  Source


The recent update of RXJS includes a change in how operators are applied.

Traditionally, operators were applied like this:

import 'rxjs/add/operator/debounceTime';
import 'rxjs/add/operator/switchMap';

export MyClass {

    // Using Reactive Forms
    .switchMap(inputVal => this.service.get(inputVal))
    .subscribe(res => console.log(res))

This approach involved modifying the Observable prototype and patching on the methods.

RXJS 5.5 introduces a different way to do this that can lead to significantly smaller code bundles, lettable operators.

To use lettable operators, modify the code from above to look like this:

//Use Deep imports here for smallest bunlde size
import { debounceTime } from 'rxjs/operators/debounceTime';
import { switch } from 'rxjs/operators/switchMap';

export MyClass {

    // Using Reactive Forms
    // We use the new `.pipe` method on the observable
    // too apply operators now

      switchMap(inputVal => this.service.get(inputVal))
    .subscribe(res => console.log(res))

This slight change allows only import the operators we need in our code. This will result in a smaller, faster application. This example uses Deep Imports, which allow the module we want to import to be isolated.

Take a look at this doc for more information.

Bug Fixes

  • action-sheet: move box-shadow to first group (4f3e91b)
  • alert: focus input after it is ready (#13259) (e555eae)
  • datetime: use spread operator to copy pickerOptions (#13202) (2ab8385), closes #11641
  • input: better support for WKKeyboard (#13106) (e7ac15f)
  • tabs: no safe area padding for top tabs (236e7f8)
  • tap-click: clear activated state on activable element when appropriate (#13258) (5742540), closes #13044
  • VirtualScroll: stop from resizing while out of view (#13143) (6978bb5)


November 8, 2017

Upgrade Instructions

ionic-angular 3.9.2 is patch release of ionic-angular 3.9.1. To upgrade, follow the instructions here for updating to ionic-angular 3.9.0. After completing those steps, update the ionic-angular version to 3.9.2.

npm install ionic-angular@3.9.2 --save

Bug Fixes

  • action-sheet: remove ios inertia scroll to fix flicker (c463b06), closes #13262


November 8, 2017

Upgrade Instructions

ionic-angular 3.9.1 is patch release of ionic-angular 3.9.0. To upgrade, follow the instructions here for updating to ionic-angular 3.9.0. After completing those steps, update the ionic-angular version to 3.9.1.

npm install ionic-angular@3.9.1 --save

Bug Fixes

  • datetime: avoid adding cancel and done button repeatedly (248a1ce)


November 8, 2017

Upgrade Instructions

ionic-angular 3.9.0 adds support for @angular 5.0.0 :tada:! It is a drop-in replacement for ionic-angular 3.8.x.

To update, remove existing node_modules and any lock files, and then update package.json to the following deps.

"dependencies" : {
  "@angular/common": "5.0.0",
  "@angular/compiler": "5.0.0",
  "@angular/compiler-cli": "5.0.0",
  "@angular/core": "5.0.0",
  "@angular/forms": "5.0.0",
  "@angular/http": "5.0.0",
  "@angular/platform-browser": "5.0.0",
  "@angular/platform-browser-dynamic": "5.0.0",
  "@ionic/storage": "2.1.3",
  "ionic-angular": "3.9.0",
  "rxjs": "5.5.2",
  "zone.js": "0.8.18"
"devDependencies: {
  "@ionic/app-scripts": "3.1.0",
  "typescript" : "2.4.2"

If your app uses RXJS, see the instructions below to update.


October 26, 2017

Upgrade Instructions

This release includes improvements for iOS11 and specifically, the iPhone X. Please also read over the iOS 11 checklist blog post for additional information.

To update, install the latest version of ionic-angular and @ionic/app-scripts:

npm install ionic-angular@latest --save
npm install @ionic/app-scripts@latest --save-dev

This release uses version 4.4.4 of Angular. Please update the version number of any @angular packages in your package.json file:

  "dependencies": {
    "@angular/common": "4.4.4",
    "@angular/compiler": "4.4.4",
    "@angular/compiler-cli": "4.4.4",
    "@angular/core": "4.4.4",
    "@angular/forms": "4.4.4",
    "@angular/http": "4.4.4",
    "@angular/platform-browser": "4.4.4",
    "@angular/platform-browser-dynamic": "4.4.4",

Bug Fixes

  • action-sheet: fix action sheet so it will scroll when the options exceed the screen (#13049) (199cb00)
  • content: reize on orientationchange only (6b848a0)
  • cordova: size footer correctly (33960f1)
  • item: safe-padding on last item only (af36358)
  • nav: remove bad assert (ae4be66)
  • navigation: account for condition of toggling one view with tabs to another view with tabs (c963745)
  • navigation: add defaultHistory support to ion-tabs (2646ebe)
  • navigation: unregister root navs when appropriate (2bd89fe)
  • overlay: onWillDismiss is called as expected (#12056) (c91223b), closes #11702
  • popover: improve positioning in ios11 (73f6a82)
  • select: overlay types should use shared interface (c4e9b5d), closes #13103
  • swiper: add safe-guards when user tries to zoom a slide without an image (#12931) (e0c8309), closes #12861
  • swiper: allow for multiple swipers on a page (#12213) (dd66f9a), closes #12008
  • tabs: emit viewDidEnter and viewDidLeave on app during tab change (c8be8e2)
  • tabs: return promises where appropriate (a77bb2c)
  • virtual-scroll: flickering issue fixes (88b2e83)
  • viewController move resize logic to viewCtrl (ebdf22d)


  • alert: export AlertButton interface (0ba33d9), closes #12545
  • input: add dir attribute for different language directions (#13043) (b180351)
  • improved ios11 support (49e0c37)


September 29, 2017

Upgrade Instructions

This release includes the latest version of zone.js. Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

"dependencies": {
    "ionic-angular": "3.7.1",
    "zone.js": "0.8.18"

Bug Fixes

  • datetime: set default to max if max before current only #9846 (39e7da3)


  • datetime: add default picker value input (b87d212)
  • datetime: default to now or max. Fixes #9846 (559f4d3)


September 28, 2017


This release adds support for the latest version of Angular (4.4.3) as well as the initial iteration of support for the iPhone X.

Upgrade Instructions

These are the latest versions of @angular, rxjs, zone.js and ionic-angular. Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

"dependencies": {
    "@angular/common": "4.4.3",
    "@angular/compiler": "4.4.3",
    "@angular/compiler-cli": "4.4.3",
    "@angular/core": "4.4.3",
    "@angular/forms": "4.4.3",
    "@angular/http": "4.4.3",
    "@angular/platform-browser": "4.4.3",
    "@angular/platform-browser-dynamic": "4.4.3",
    "ionic-angular": "3.7.0",
    "rxjs": "5.4.3",
    "zone.js": "0.8.17"
"devDependencies": {
  "@ionic/app-scripts": "3.0.0"

If you're using a package-lock.json file, make sure that is updated as well.

Bug Fixes

  • input: mark ion-input touched on blur instead of changed (#12812) (d0cad6b), closes #12102
  • swiper: change var to let to avoid variable shadowing (f5ef1ca)


  • initial iphoneX support (112d4f5)


September 7, 2017

Upgrade Instructions

ionic-angular@3.6.1 is a drop-in replacement for 3.6.0. To install it, please run:

npm install -g ionic@latest
npm install @ionic/app-scripts@2.1.4 --save-dev
npm install ionic-angular@3.6.1 --save

Bug Fixes

  • generators: Update documentation URLs for templates (475b722)
  • navigation: check existence of done transition callback (#12640) (0a6bb3b)
  • navigation: ensure secondaryId always has a string value (#12641) (1069505)
  • navigation: fix popTo signature and make usage uniform (3187375)
  • slider: guard the processing of _slides (b809665), closes #12791


July 27, 2017

Upgrade Instructions

ionic-angular 3.6.0 requires developer's to update to the latest version of the Ionic CLI and @ionic/app-scripts.

To upgrade, please run

npm install -g ionic@latest
npm install @ionic/app-scripts@latest --save-dev
npm install ionic-angular@latest --save


The URL when using deep linking is shortened and improved in this release. Due to a limitation in our nav system, if you're using ion-tabs and have a tab name that matches a segment, meaning you have a tab name of schedule and a segment of schedule, there could potentially be issues. To mitigate these issues, make sure you set the tabUrlPath property on the ion-tab and give it a unique name. This limitation will require an API change to fix so it will be resolved in ionic-angular 4.x.

The upgrades include necessary changes to generators that add back lazy loading functionality, as well as an improved way of generating component/directives/and pipes.

New Generators

The release adds back the functionality to generate lazy loaded pages. To generate a lazy loaded page, run:

ionic g page <Page-Name>

This will include a .module.ts file in the page directory created. If you do not want to generate a lazy loaded page, you can run:

ionic g page <Page-Name> --no-module

This will also generate lazy loaded tabs as well, accepting the --no-module flag as well to disable it.

For pipes/components/components, we now generate a shared common module for each of these.

So running:

ionic g component music-card

Will create a components/components.module.ts file that declares and exports the music-card component. We think that this will allow developers to get up and running with custom components much faster and will less overhead.

Bug Fixes

  • list: remove margin of MD buttons in ion-item-options (#12263) (97f9522)
  • nav: make call to setPages return the promise so if it rejects it doesn't get lost (de0f9d5)
  • navigation: account for race conditions in developer's code (4596dbe)
  • navigation: fix bug where that occurred when tab identifier and segment had the exact same string (add0c4e)
  • navigation: fix null pointer exceptions that would occur when destroying a nav controller while its transitioning (584afd0)
  • navigation: reduce urls to minimum set of fields (a8ceee4)


  • generators: refactor generators (400aa54)


July 14, 2017

Upgrade Instructions

ionic-angular@3.5.3 is a drop-in replacement for 3.5.2. To install it, simply run npm install ionic-angular@3.5.3 --save --save-exact.

Bug Fixes

  • app: restore getActiveNav api (2d49e10)


July 13, 2017

Upgrade Instructions

ionic-angular@3.5.2 is a drop-in replacement for 3.5.1. To install it, simply run npm install ionic-angular@3.5.2 --save --save-exact.

We have released a new version of our build process for ionic-angular apps, @ionic/app-scripts in conjunction with this release of ionic-angular. While it's not a required update, we recommend it because we have greatly improved the developer experience. Incremental, or update builds while developing are much faster now. We've also added scope hoisting for better start-up performance on production builds.

To upgrade to @ionic/app-scripts, run the following command:

rm -rf node_modules
npm install @ionic/app-scripts@2.0.2 --save-dev --save-exact

After installing the update, you'll need to make a minor change to the src/index.html file to include a new <script> tag for build/vendor.js. The reason for this breaking change in @ionic/app-scripts is for faster builds. By separating out the node_modules dependencies into a vendor.js file, the incremental build is faster.


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

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

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

  <!-- The vendor js is generated during the build process
       and includes all files in the node_modules directory -->
  <script src="build/vendor.js"></script>

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


If you're customizing @ionic/app-scripts, we recommend you review the changelog, and update any of your configs accordingly.


3.5.2 is the same as 3.5.1. We had a small publishing error.

Bug Fixes

  • navigation: fix swipe-to-go-back (04e78d8)
  • navigation: mark as not transitioning on success in addition to '_transitionFinish', provide no (48b3243)
  • navigation: navs can have n child navs instead of just one (fce4422)
  • navigation: restore getActiveChildNav method to maintain old API, add deprecation notice (d22d77b)
  • navigation: ts2.4 compatibility (08be9dc), closes #12233 #12235
  • select: not activated on enter in input field (ad25cd1), closes #12202
  • sliding-item: ionSwipe event is fired (#12157) (b5aa304), closes #12146
  • tabs: have tabs behavior match nav when navigating back/forth via the url (3f39e14)


  • navigation: support for named ion-nav/ion-tabs to improve url in the short term (486bff0)


July 13, 2017

See the 3.5.2 changelog. We had a publishing error here.


June 28, 2017

Steps to Upgrade

ionic-angular should be set to version 3.5.0.

npm install ionic-angular@3.5.0 --save --save-exact


There were major improvements made to navigation in this release of ionic-angular. Specifically, we updated Ionic to support a concept of n root navigation elements, instead of just one. This will enable first-class url support for things split-pane. Before 3.5.0, only one section of the screen could be represented in the URL. With these changes, multiple sections can be. Another large change was improving the behavior surrounding browser behaviors, such as the back-and-forward buttons, as well as refresh. In general, Ionic should work much more intuitively in a web browser now.

As a result of these improvements, if you're using deep linking, the urls of the application will be different with 3.5.0 than they were with previous Ionic releases. The URLs will likely change again in the near future with the next round of navigation improvements too. For now, we don't recommend using href attributes in the application. Using the navPush and navPop directives is a better option for now while URL support is being built-out.

Bug Fixes

  • navigation: add isTab check to getSegmentsFromNav (f39c381)
  • navigation: fallback to name if component does not exist on segment (30f69c8)
  • select: _inputUpdated should not be called manually (8dc08f9)
  • select: floating label (e3a8d27), closes #12068
  • tabs: use segment if it exists even if component exists (016b90d)


June 16, 2017

Bug Fixes

  • rtl: use multi direction in order to override the default ltr (70b5b6)


June 16, 2017

Bug Fixes

  • themes: change default app-direction (1ca7df)


June 15, 2017

Steps to Upgrade

ionic-angular should be set to version 3.4.0 in the package.json dependency list. The latest @angular release 4.1.3 is also supported. Feel free to update apps by updating the package.json dependencies to match below.

"dependencies": {
  "@angular/common": "4.1.3",
  "@angular/compiler": "4.1.3",
  "@angular/compiler-cli": "4.1.3",
  "@angular/core": "4.1.3",
  "@angular/forms": "4.1.3",
  "@angular/http": "4.1.3",
  "@angular/platform-browser": "4.1.3",
  "@angular/platform-browser-dynamic": "4.1.3",
  "@ionic-native/core": "3.12.1",
  "@ionic-native/splash-screen": "3.12.1",
  "@ionic-native/status-bar": "3.12.1",
  "@ionic/storage": "2.0.1",
  "ionic-angular": "3.4.2",
  "ionicons": "3.0.0",
  "rxjs": "5.4.0",
  "sw-toolbox": "3.6.0",
  "zone.js": "0.8.12"
"devDependencies": {
  "@ionic/app-scripts": "1.3.7",
  "typescript": "2.3.4"

Bug Fixes


  • background-position: add background position support for rtl (#11946) (305c306)
  • loading: add enableBackdropDismiss to Loading (#11937) (d0ae810), closes #7975
  • loading: add margin start variable (#11980) (3e0d43e)
  • rtl: add transform and transform-origin support for rtl (#11649) (2273fb5)
  • rtl: optimize the new mixins for smaller bundle, ltr separation (#11635) (f0c6948)
  • rtl: support flipped svg background images on rtl (#11945) (f4452b5)
  • slides: support centering slides and using decimal numbers (e3c60c5), closes #10361

Performance Improvements


May 24, 2017

Steps to Upgrade

ionic-angular now supports the latest @angular (4.1.2), and typescript (2.3.3) versions. Feel free to update apps by updating the package.json dependencies to match below:

"dependencies": {
  "@angular/common": "4.1.2",
  "@angular/compiler": "4.1.2",
  "@angular/compiler-cli": "4.1.2",
  "@angular/core": "4.1.2",
  "@angular/forms": "4.1.2",
  "@angular/http": "4.1.2",
  "@angular/platform-browser": "4.1.2",
  "@angular/platform-browser-dynamic": "4.1.2",
  "@ionic-native/core": "3.10.2",
  "@ionic-native/splash-screen": "3.10.2",
  "@ionic-native/status-bar": "3.10.2",
  "@ionic/storage": "2.0.1",
  "ionic-angular": "3.3.0",
  "ionicons": "3.0.0",
  "rxjs": "5.1.1",
  "sw-toolbox": "3.6.0",
  "zone.js": "0.8.11"
"devDependencies": {
  "@ionic/app-scripts": "1.3.7",
  "typescript": "2.3.3"

Another optional step is to remove the src/declarations.d.ts file. This is a legacy file introduced early with ionic-angular projects to improve compatibility between TypeScript and third-party libraries. Due to improvements in TypeScript, this file is no longer necessary. By removing this file, the TypeScript compiler will be able to provide more accurate error messages for import statements.

Bug Fixes


  • icon: add flip/unflip for icon on rtl (#11634) (7bdfaac)
  • rtl: add rtl margin, padding, position and border-radius (#11342) (a30379b)


May 12, 2017

Bug Fixes

  • label: set the ios variables to null to avoid styling (2c66c56), closes #11631
  • searchbar: update signature mismatch in template & class (#11599) (4347627), closes #11598


May 10, 2017

Steps to Upgrade

Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

"dependencies": {
  "@angular/common": "4.1.0",
  "@angular/compiler": "4.1.0",
  "@angular/compiler-cli": "4.1.0",
  "@angular/core": "4.1.0",
  "@angular/forms": "4.1.0",
  "@angular/http": "4.1.0",
  "@angular/platform-browser": "4.1.0",
  "@angular/platform-browser-dynamic": "4.1.0",
  "@ionic-native/core": "3.6.1",
  "@ionic-native/splash-screen": "3.6.1",
  "@ionic-native/status-bar": "3.6.1",
  "@ionic/storage": "2.0.1",
  "ionic-angular": "3.2.1",
  "ionicons": "3.0.0",
  "rxjs": "5.1.1",
  "sw-toolbox": "3.6.0",
  "zone.js": "0.8.10"
"devDependencies": {
  "@ionic/app-scripts": "1.3.7",
  "typescript": "2.2.1"

Using v3 of the Ionic CLI? Make sure to add @ionic/cli-plugin-ionic-angular and @ionic/cli-plugin-cordova to your devDependencies. Read more about this on our blog.

Bug Fixes

  • button: display box shadow correctly for Chrome (cbe0b42)
  • datetime: fix floating label with empty ion-datetime (#11552) (5a895bb), closes #11547
  • label: add the $label-ios-text-color sass variables back (588fad8), closes #11373
  • module-loader: remove null references (2afc5cf)
  • nav-controller: popToRoot should not remove root view (646d736)
  • rtl: add correct text-align (#11353) (424b15a)
  • rtl: change item reorder offset for RTL (#11395) (665e44f)
  • select: fire the events properly in popover interface (59dd853)
  • tap-click: update setupTapClick signature (df8d1cc)
  • view-controller: set _dismissRole to a string (6d11499)
  • virtual-scroll: update virtualTrackBy reference (de19dbe)
  • virtual-scroll: remove duplicate items (f893aa6)
  • virtual-scroll: initialize differ with trackByFn (#11492) (299a68b)


  • item: deprecate item-left / item-right attributes for item-start / item-end (#11125) (26c653e)
  • select: close select programatically (a04b577)
  • wk: built-in support for WK (#11048) (325cc5e)

Performance Improvements

  • virtual-scroll: relax the restrictions for fast path (88e5642)
  • virtual-scroll: fast path for removing (8baa647)


April 28, 2017

Bug Fixes

  • datetime: return the correct value (af394b5)
  • datetime: always returns a string (6677d80)
  • input: don't dispatch first ngModel update (505d27a)
  • input: initialize in ngAfterContentInit (239b559)
  • menu: missing output events in interface (7eb2f0b), closes #11383
  • range: fix label reference (ee6c481)
  • searchbar: add setFocus() back (9264a04), closes #11397
  • select: use correct assert condition (ec2a34d)
  • select: return the value in ionChange instead of this (d24c4f4)
  • select: allow object as value (4c8efc2)
  • select: remove private reference (c0276d5)
  • toggle: initialize in ngAfterContentInit (539901d)


April 26, 2017

Steps to Upgrade

Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

"dependencies": {
  "@angular/common": "4.0.2",
  "@angular/compiler": "4.0.2",
  "@angular/compiler-cli": "4.0.2",
  "@angular/core": "4.0.2",
  "@angular/forms": "4.0.2",
  "@angular/http": "4.0.2",
  "@angular/platform-browser": "4.0.2",
  "@angular/platform-browser-dynamic": "4.0.2",
  "@ionic-native/core": "3.4.2",
  "@ionic-native/splash-screen": "3.4.2",
  "@ionic-native/status-bar": "3.4.2",
  "@ionic/storage": "2.0.1",
  "ionic-angular": "3.1.1",
  "ionicons": "3.0.0",
  "rxjs": "5.1.1",
  "sw-toolbox": "3.4.0",
  "zone.js": "^0.8.5"
"devDependencies": {
  "@ionic/app-scripts": "1.3.4",
  "typescript": "~2.2.1"

Bug Fixes

  • input: trigger inputUpdated on initialize (5776f76)
  • input: make sure isDisabled gets set to a boolean (bfa2362)
  • item-options: rtl support (#11188) (ea6450e)
  • menu: rtl support (5311336)
  • menu: rtl support (51d5079)
  • nav-controller: print exceptions inside lifecycle events (95c06a5), closes #10974
  • nav-controller: filter null view-controllers (8605672)
  • nav-controller: queue lazy loading (f88823a)
  • nav-controller: fix crash when it is destroyed (cc1eb02), closes #11338
  • navigation: legacy deeplink config can have a defaultHistory entry that is a component (35f3947)
  • platform: resize events are dispatched inside zone (83509db)
  • scroll: fix memory leak (3c8edba)
  • searchbar: debounce input for ionInput (11a1c70)
  • select: stores string | string[] (ba44780), closes #11337
  • slides: fix fast rerendering crash (#11100) (78d427d), closes #10830
  • sliding-gesture: add missing return value (3b32b8e)
  • tabs: invalid component comparison (#11084) (e423e08)
  • toggle: use correct toggle background color for iOS colors (b3d68c9)
  • util: pass an option to default to right side in isRightSide (7bcf5a0)
  • virtual-scroll: create views inside zone (fd3c6ba), closes #10451
  • virtual-scroll: supports null records (67af71b)


  • app: add pull-left/right/start/end (#11214) (d9ac950)
  • app: add text-start and text-end (#11213) (6cd719f)
  • app: add responsive utility attributes by screen size (#11228) (cf24057), closes #10567
  • item: add sass variable to override avatar border radius (b0dc856), closes #10763
  • label: fix positioning of floating label for rtl (#11324) (0ec71cd)
  • list: rtl support for list-header (#11328) (e31a4da)
  • modal: add cssClass to modal options (5cb51ef), closes #10020
  • platform: add electron as a platform (#10868) (c0df862)
  • rtl: add start and end text-align for alert and picker (cb5707d)
  • segment: add segment rtl support (#11215) (dd0b293)
  • select: add popover interface as an option (745d808)

Performance Improvements

  • toggle: css containment (93d1d02)
  • toggle: events are not zoned (bda624f)
  • toggle: toggle's button is not activated (17c0543)


April 6, 2017

Bug Fixes


April 5, 2017


With this release comes a major update to Angular (Angular 4.0!), the latest version of TypeScript, and some optional structural changes to your application.

  1. Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

    "dependencies": {
       "@angular/common": "4.0.0",
       "@angular/compiler": "4.0.0",
       "@angular/compiler-cli": "4.0.0",
       "@angular/core": "4.0.0",
       "@angular/forms": "4.0.0",
       "@angular/http": "4.0.0",
       "@angular/platform-browser": "4.0.0",
       "@angular/platform-browser-dynamic": "4.0.0",
       "@ionic-native/core": "3.4.2",
       "@ionic-native/splash-screen": "3.4.2",
       "@ionic-native/status-bar": "3.4.2",
       "@ionic/storage": "2.0.1",
       "ionic-angular": "3.0.1",
       "ionicons": "3.0.0",
       "rxjs": "5.1.1",
       "sw-toolbox": "3.4.0",
       "zone.js": "^0.8.4"
    "devDependencies": {
     "@ionic/app-scripts": "1.3.0",
     "typescript": "~2.2.1"
  2. Import the BrowserModule in your app/app.module.ts file:

    import { BrowserModule } from '@angular/platform-browser';

    and then add it to the imports in the same file:

    imports: [
  3. If you are using Http, import the HttpModule in your app/app.module.ts file:

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

    and then add it to the imports in the same file:

    imports: [
  4. Upgrading to Ionic Native 3.x will result in a smaller bundle size. With Ionic Native 3, native functionality was moved from static methods to using Angular injectables.

And that’s it! Your app should still function the same without any issues.

Bug Fixes

  • alert: add missing cssClass property for buttons (4fbcda7)
  • content: remove scroll bouncing from desktop (7cee7b0)
  • content: enable scroll listener automatically (d9a7652), closes #10938
  • datetime: emit ionCancel event on backdrop click (#10532) (4ac8ffb)
  • datetime: remove unnecessary calls and performance improvements (99142f8)
  • infinite-scroll: don't call complete if the state isn't loading (58b57c0)
  • item-sliding: add forwardRef for item options (0ccd96e)
  • navigation: update the URL if there are no children navs (8586cc1)
  • slides: negative number indicates position starting at end (#10997) (33be36d)
  • split-pane: add RTL support (57f3f97), closes #10903
  • virtual-list: fix the rendering of the first item (ccb49f3)
  • virtual-list: update compatibility with angular (682ce49)

Code Refactoring

  • grid: remove the old grid system (19c36de)
  • typography: remove the native element selectors (2827275)


  • module-loader: add caching for ngModuleLoader on load (17359b7)
  • module-loader: add preloadModules config option, set to false (bdbd521)
  • module-loader: preload modules based on priority (5a4f8b9)
  • module-loader: run outside of angular and in requestIdleCallback (c7ad3ce)
  • navigation: @DeepLink decorator (3e70856)
  • navigation: add optional priority to deep link config (b47848c)
  • split-pane: adds enabled input (fa7ea0c), closes #10949
  • split-pane: sizing via scss variables (979ca63), closes #10893
  • util: system.js ng-module loader (beabe32)



Removed the deprecated (old) grid. See the blog post for more information including steps to migrate:


The following selectors to style the text color of the native text elements have been removed:

h1[color], h2[color], h3[color], h4[color], h5[color], h6[color], a[color]:not([ion-button]):not([ion-item]):not([ion-fab]), p[color], span[color], b[color], i[color], strong[color], em[color], small[color], sub[color], sup[color]

These have been throwing a deprecation warning since rc.3 but still working. They are officially gone and therefore these elements will not get the color unless the ion-text attribute is added. Please see the documentation for more information:


The following properties and functions have been printing console warnings and are officially removed:

Slides input options has been removed. Please use the input properties instead.

Slide event ionWillChange has been removed, please use ionSlideWillChange instead.

Slide event ionDidChange has been removed, please use ionSlideDidChange instead.

Slide event ionDrag has been removed, please use ionSlideDrag instead.

Slides getSlider() method has been removed, please use the instance of ion-slides.


Ionic has been updated to depend on Angular 2.4.8, which is the latest version that we have tested and confirmed to be compatible with Ionic. This means that updating to the 2.2.0 release of Ionic will automatically work with all of the performance updates, bug fixes and features in Angular 2.4.8!

Ionic Storage

We recently released the 2.0.0 version of ionic-storage. If you are using Ionic Storage in your application, you need to update to this version of ionic-storage. Attempting to use an older version of ionic-storage with Ionic 2.2.0 will cause errors. You can read about how to update to ionic-storage 2.0.0 here.

Bug Fixes

  • components: clean up event listeners to stop memory leaks (8d9f374), closes #10459 #10416 #10286
  • infinite-scroll: use icon color from Sass var and add var for text color (7b97fb7), closes #10574
  • menu: disable the menus when they should be (dc53c8e)
  • menu: don't hide menuToggle outside navbar (e56bad9)
  • radio: calculate radio-inner width/height with border width (#10495) (176aa23)
  • refresher: don't destroy events manager (9308694), (1dd8883), closes #10652
  • refresher: use refresher icon color from Sass var (116ae38), closes #10479
  • tabs: emit ionChange after the tab is selected (ac1a886), closes #10538
  • tabs: catch the rejected promise with popToRoot (7385158)
  • view-controller: set navigation so dimiss() will work synchronously. (61a5317), closes #10654


  • alert: add ability to set the mode on alert (f577e54)
  • split-pane: split pane support for ion-nav and ion-menu (#10343) (9e4c3a6)
  • typography: add text-wrap attribute for all elements (2c2b87b), closes #7051


March 22, 2017

Bug Fixes

  • alert: pass id to alert inputs (46fe1ff), closes #10603
  • datetime: don't always disable day values when dayValues is set (eff420f)
  • datetime: move the call to picker.refresh() in generate (58beea3)
  • datetime: respect time limits in hours and minutes (afd99ba), closes #6850
  • datetime: update selectedIndex according to ngModel value (74191c3)
  • infinite-scroll: add event.timeStamp polyfill for firefox (#10752) (53feb3f)
  • picker: initialize the selectionIndex (ba35306)
  • range: update the bar width correctly (b541832), closes #10150
  • range: only activate knob B if range is dual (d538245)
  • scroll-view: do not set initialized until it is enabled (#10817) (56364a0)
  • searchbar: add IE support (05859db)
  • select: make floating labels work for ion-select (8c483f2), closes #10751
  • slides: fix rtl support (e90d692)
  • slides: simulate touch events for query params (#10579) (e191321), closes #10577
  • toggle/checkbox: trigger ui update when using virtalScroll with Angular Reactive Forms (30980b6)
  • virtual-list: make virtual-scroll work with infinite-scroll (999efac), closes #9350 #9722 #9247 #10778
  • virtualscroll: populate the nodes at the correct height (51c398d)


  • alert: add attributes min & max to alert inputs (d666e8b)
  • alert: add attributes min & max to alert inputs of type number (b53219a)
  • infinite: add scroll in opposite direction (#8099) (6918275)
  • infinite-scroll: add waitFor method to InfiniteScroll (84e25a1)
  • overlay: add method chaining pattern to configure overlays (bee75f7)
  • range: add ionFocus and ionBlur events (#10761) (8f310eb)
  • split-pane: support for side=right (963cdcb)

Performance Improvements

  • content: scrollview magic activated on demand (7e9bad5)


  1. Update your package.json to match the following dependencies, remove the existing node_modules directory, and then run npm install:

     "dependencies": {
       "@angular/common": "2.4.8",
       "@angular/compiler": "2.4.8",
       "@angular/compiler-cli": "2.4.8",
       "@angular/core": "2.4.8",
       "@angular/forms": "2.4.8",
       "@angular/http": "2.4.8",
       "@angular/platform-browser": "2.4.8",
       "@angular/platform-browser-dynamic": "2.4.8",
       "@angular/platform-server": "2.4.8",
       "@ionic/storage": "2.0.0",
       "ionic-angular": "2.2.0",
       "ionic-native": "2.4.1",
       "ionicons": "3.0.0",
       "rxjs": "5.0.1",
       "sw-toolbox": "3.4.0",
       "zone.js": "0.7.2"
     "devDependencies": {
       "@ionic/app-scripts": "1.1.4",
       "typescript": "2.0.9"

    Note: If you are using ionic-storage, you need to update it to 2.0.0 or you will run into an error similar to this: Error: Can't resolve all parameters for Storage: (?, ?).. For more information, see the Storage Documentation.

What's new

Split Pane

As part of our initiative to improve desktop support we have introduced a new component called Split Pane. Split Pane makes it possible to easily create multi-view layouts. It allows elements, such as a menu or another navigation pane, to be displayed on large viewports. Split Pane can be used to achieve a layout similar to the Gmail (Android) or Mail (Apple) applications.


March 8, 2017


February 23, 2017

Bug Fixes

  • content: check for scroll element before modifying it (#10374) (6a0c92c)
  • platform: resize platform correctly (54e50f)


  • alert: add sass variables for checkbox and radio button text color (#10331) (9cd42dd)
  • datetime: add placeholder attribute (52a6d41), closes #7966
  • grid: improve grid to a column layout with more flexibility (#10485) (6ceec7a), closes #6050 #7508


February 8, 2017

Bug Fixes

  • chip: align icon in the center (ace727e), closes #5386
  • content: check for this._scroll when reading dimensions (#10216) (96f550c)
  • datetime: set input-has-value class without formControlName (#8947) (81c3394)
  • input: add variables for alert and input placeholder color (4ca9f2c), closes #10153
  • input: add max, min, step as inputs and pass to native (803782a), closes #10189
  • input: don't allow focus when disabled is set (#10214) (eba0866), closes #10155
  • platform: detect iPad Pro correctly (#10292) (f12fc61)
  • toggle/checkbox: allow value to be programmatically updated while disabled (#10304) (b8ee301), closes #9730


January 25, 2017

Enjoy! :tada:


January 24, 2017


  1. Update the framework:

     npm install --save --save-exact ionic-angular@2.0.0-rc.6
  2. Change the import for ionicons in your theme/variables.scss file from this:

     @import "ionicons";


     @import "ionic.ionicons";

    See the conference app for an example. This fixes a bug with ionicons getting styled incorrectly.

Bug Fixes

  • alert: input missing id attribute from input options (6da9eb6), closes #9457
  • alert: unhandled promise exception (ee2268f)
  • checkbox: set disabled state from FormControl (b44ff41)
  • content: unsubscribe from viewCtrl observables after content ins… (#10050) (3a718de), closes #9593 #10045
  • datetime: set disabled state from FormControl (99c493e)
  • gestures: drag events are debounced (23a70e1)
  • input: pass disabled down to input when it is set from form (5844a83), closes #9834
  • input: pass readonly from ion-input down to native input (f9a576e), closes #6408
  • input: show clear-input on inputs with ngModel/formControlName (7a6ba2d), closes #9077
  • item-sliding: don't error or allow swipes with no options (421b7da), closes #9914
  • modal: overlay-zindex is not changed in back direction (fba1596), closes #9409
  • nav: swipe back after getRootNav().push (eaa6248), fixes #9558 (#9767)
  • nav-pop: add catch for unhandled promise exception (b995ca8)
  • nav-push: add catch for unhandled promise exception (8c4fd56)
  • platform: detect the orientation correctly (8840124)
  • range: set disabled state from FormControl (8e64a28)
  • select: set disabled state from FormControl (40e7eb2)
  • slides: allow auto to be passed (e56028e), closes #10000 #10037
  • tabs: ionChange event is dispatched after the switch (ba9e7b3)
  • tap: allow document to be tap polyfilled (9168bc1), closes #9726
  • toggle: set disabled state from FormControl (0aad835)


  • radio: add disabled to radio-group and support disabled formcontrol (3e9427b), closes #9998
  • slides: add option for paginationBulletRender (21667c6), closes #10002
  • slides: add swiper controller (#9983) (f499496)
  • slides: expose more options (#9992) (2d26edb), closes #9988


January 11, 2017


  1. Update to the latest version of the Ionic CLI:

    npm uninstall -g ionic
    npm install -g ionic
  2. Update your package.json to match the following dependencies, remove existing node_modules directory, and then run npm install:

    "dependencies": {
       "@angular/common": "2.2.1",
       "@angular/compiler": "2.2.1",
       "@angular/compiler-cli": "2.2.1",
       "@angular/core": "2.2.1",
       "@angular/forms": "2.2.1",
       "@angular/http": "2.2.1",
       "@angular/platform-browser": "2.2.1",
       "@angular/platform-browser-dynamic": "2.2.1",
       "@angular/platform-server": "2.2.1",
       "@ionic/storage": "1.1.7",
       "ionic-angular": "2.0.0-rc.5",
       "ionic-native": "2.2.11",
       "ionicons": "3.0.0",
       "rxjs": "5.0.0-beta.12",
       "zone.js": "0.6.26",
       "sw-toolbox": "3.4.0"
     "devDependencies": {
       "@ionic/app-scripts": "1.0.0",
       "typescript": "2.0.9"

    Note: please ensure you are using the exact TypeScript and Angular versions listed above. There have been issues with the latest versions.

What’s changed?

Internal refactor completed in order to improve tree shaking and dead code removal. The public API, with the exception of the slides component, has stayed the same. However, internally many changes were required so bundlers could better exclude modules which should not be bundled. Ultimately most changes resorted to removing references to window or document, or a module that referenced one of those.

What’s new?

Service Worker Toolbox (sw-toolbox) is now built in to the starters and conference app. This allows you to customize your service worker using a high level API instead of using the raw service worker API. Our out of the box configuration will give your app a good, network independent experience but you can easily customize this to fit your app’s unique use cases.



As part of the refactor to improve tree shaking the TextArea has been merged into the TextInput class. This means that if you are importing the TextArea class you will need to change this to be TextInput.


ion-slides was refactored to remove the external dependencies, and rewritten in TypeScript/ES6 modules to again improve tree shaking abilities. In order to work with tree shaking, the options attribute had to be removed. See the Slides API Documentation for usage information.

Bug Fixes

  • clickblock: add NavOptions.minClickBlockDuration (8ca9797)
  • datetime: enable custom day values (#9708) (acba3c0), closes #7190 #7190
  • input: fix the text jumping for stacked/floating inputs on iOS (877fcf1), closes #9605
  • input: only add padding right if it has clear input (717cada), closes #9865
  • input: remove click events from disabled inputs (#9676) (22ba043), closes #9070
  • list: add border to last item in MD list (#9679) (64346bd), closes #9619
  • overlay: don't call to dismiss pages if the view is an overlay (8b25798)
  • platform: only set isPortrait when the width/height is set (e9adab0)
  • scroll: handle low duration in scrollTo (14eb2fd)
  • show-hide-when: remove whitespaces from conditions before check phase (#9573) (cd342c2)
  • tabs: current tab still active if selected tab does not have a root (f09c300), closes #9392 #9811 #9392


December 15, 2016


  1. Update the Ionic CLI to the latest version:

    npm uninstall -g ionic
    npm install -g ionic
  2. Update the following dependencies in your package.json file:

    "dependencies": {
     "@angular/common": "2.2.1",
     "@angular/compiler": "2.2.1",
     "@angular/compiler-cli": "2.2.1",
     "@angular/core": "2.2.1",
     "@angular/forms": "2.2.1",
     "@angular/http": "2.2.1",
     "@angular/platform-browser": "2.2.1",
     "@angular/platform-browser-dynamic": "2.2.1",
     "@angular/platform-server": "2.2.1",
     "@ionic/storage": "1.1.7",
     "ionic-angular": "2.0.0-rc.4",
     "ionic-native": "2.2.11",
     "ionicons": "3.0.0",
     "rxjs": "5.0.0-beta.12",
     "zone.js": "0.6.26"
    "devDependencies": {
     "@ionic/app-scripts": "0.0.47",
     "typescript": "2.0.9"
  3. A major version of @ionic/app-scripts was recently released. Please review the changelog for the details on the minor breaking changes to the release:

Bug Fixes

  • action-sheet: set border bottom of last button to transparent (ffdd8f4)
  • activator: cancel remove .activated timeout (9510a2b)
  • alert: fix alert input focusing and keyboard (29a56c4)
  • alert: close keyboard when alert leaves (f354d91), closes #8185
  • animation: improve menu and go back swipe (4be47bd)
  • app: go back navigation can close menus (8de253a)
  • app: navPop() can go back inside modals (2ac3b4a), closes #7611
  • app: navPop() does not go to previous tab (eebb062)
  • app-root: async disable-scroll is cancelled properly (177a089)
  • avatar: make border-radius 50% so it is always circular (e84f2e2)
  • backdrop: remove click cursor when the backdrop is not tappable (06938b6)
  • clickblock: clickblock applies longer (e0d876e)
  • components: set true/false inputs to booleans (a796786), closes #9391
  • components: export ClickBlock (6244b51)
  • content: add a new variable for calculating fixed content top/bottom (8037086)
  • content: get correct content dimensions (1d245ec)
  • content: prefix utility attributes with ion-app and the mode (abc7395), closes #8765
  • datetime: fix am/pm in format w/out minutes or seconds (95b3b38), closes #9269
  • dateTime: make sure picker-column is shown on retina screens (b17950d)
  • fab: add box shadow transition for md fab list buttons (1e2374f), closes #9557
  • fab: fab list colors (cbf59fa), closes #9225
  • fab: position fab-list correctly on IE (a0b61f2)
  • fab: set ripple color to contrast color of the fab background (0888dec)
  • fab: using as fab (0e773fa)
  • fonts: auto-set ionicons font path if not already set (7bbfb7e)
  • gesture: nativeRaf is unsafe (b63344c)
  • gesture: pass type to hammer.get() so pinch and rotate can be enabled (66afe34)
  • header: fix no-border on ios headers (d53a38e), closes #9525 #9480
  • img: ensure scroll has been initialized (39e1dce)
  • img: fix content viewable area (903473e)
  • img: move img requests out of web workers (5376318)
  • img: use img tag due to cordova limitations (4f61ea5)
  • input: add back old styles to fix input margin (e09aee4)
  • input: apply transform css prefix (eba2862)
  • input: fix input margins while scrolling (67473f2)
  • input: fix tabbing between tappable inputs (c4cf9df)
  • input: improve scroll to input and focusing (3b30497)
  • input: prevent exception when input components outside Content (e80f4cf)
  • input: stop ios from hiding keyboard on focus change (5bcd7f2)
  • input: test for null element before update (f0327a9), closes #9278
  • item: disable scroll while sliding item (c002b36)
  • item: tappable does not make ion-label pointer-event:none (4512c5c)
  • keyboard: fix keyboard tabbing context (902a767), closes #9568
  • labels: consistent label styles on iOS (b788ce6)
  • list: tweak list header color to match spec (053c754)
  • menu: clicking the backdrop/content closes the menu (eafd13f)
  • menu: disable menu swipe while transitioning (168428e)
  • menu: improves menu swipe animation (91478ed)
  • menu: two menus can’t be animated at the same time (1e95e85)
  • menu-toggle: move logic for css class to the menu toggle (624cb35), closes #8943
  • modal: app.navPop() can dismiss modals (5567191), closes #8692
  • modal: backdrop click catches navigation promise (e46d8d6)
  • modal: using cross mode animations (ccb6bf1), closes #9323
  • module: add ClickBlock to NgModule declarations (960399a)
  • nav: async removing for views (5ff7072)
  • nav: back button and title not aligned on baseline (d82bb01), closes #8983
  • nav: popTo() uses the new removeView API (6b3e2ed)
  • nav: prevents to remove all views in the nav stack (16bfb49), closes #9140
  • navbar: go back text (58189d2)
  • note: separate note from item so its styles will alway be applied (bf00803), closes #9173
  • picker: add color to picker-opt so the variable will style correctly (dc0659f), closes #9519
  • picker: making touchable fill all the available space (448e020)
  • picker: mark main button as strong (af7139b)
  • picker: removes unused code (44d772f)
  • picker: stop picker once it is closed (ecb8bee)
  • platform: fix window width/height calculations (4ed6b36)
  • popover: remove css contain from popover (db9f1a8)
  • ripple: disable ripple on android 4.4 with chrome (97ec20e)
  • scroll: correctly resolve promise (c6fbb9c)
  • scroll: ensure listeners have been added before removing (a237253)
  • scroll: fix content dimensions for js scrolling (c510100)
  • scroll: fix js scrolling max and deceleration on touch start (5bbbfb2)
  • searchbar: animated + no cancel works as expected (851187a), closes #8903
  • tab: tab button without content does not crash (81a0969)
  • tabs: _touchActive() works when tab.root is a string (cb65f79)
  • tabs: adjust the top of tabs each time the tab changes (3b612d2)
  • tabs: make MD tab highlight the contrast color of tabs color (bb3a57f)
  • tabs: update UI to match material design spec (e7275f2)
  • tap-click: do not dispatch click events if tap-click blocks them (8f8185b)
  • tap-click: click to non-activable elements (c6facf3)
  • toast: toast does not disable the app (75186b4), closes #9339
  • toggle: uses PanGesture abstraction (6ef6f0a), closes #9428
  • toolbar: remove calculated height (b7cac56)
  • util: click-block transform on IE (fcba323)
  • util: replace implicit any in dom-controller (#9511) (6c0593c)
  • view-controller: onDidDismiss() is always called (68eb1b7), closes #8223
  • virtual-scroll: ensure listeners added after init read (76ff421)
  • virtual-scroll: fix image rendering bug (72276c3), closes #6983
  • virtual-scroll: fix tabs content loading (aec8f51)
  • virtual-scroll: only allow one readUpdate per update (8104cfa)
  • virtual-scroll: redraw empty list when updated with no records (288df86), closes #6512

Code Refactoring

  • toolbar: rename no-shadow to no-border for md mode (b73304e)


  • button: add strong decorator (fa0579f)
  • button: make strong configurable in Sass (ac07c6f)
  • content: add properties for img request/render buffers (8867677)
  • content: content dimension properties w/out dom read (19aa633)
  • dom-controller: organize dom reads/writes (cac7164)
  • keyboard: blur input on native keyboard hide (1809c40)
  • reorder: add applyTo method to ionItemReorder event (7e6d73b)
  • scroll: add domWrite and content elements to scroll events (bfd3314)
  • template: add NavParams to page template (8587191)
  • virtual-scroll: apply contain:strict to virtual scroll items (947780e)

Performance Improvements

  • activator: cancelled touch does not cause layout thrashing (22d6bc5)
  • activator: improve activator response (bb80033)
  • app: adds fast path in isEnabled() and isScrolling() (5526d70)
  • events: ionDrag events are not zone wrapped (a722107)
  • menu: improves menu performance and fixes some edge cases (3209895)
  • menu: using passive events in menu (788a7b6)
  • nav: minor performance improvements (4aa1ada)
  • range: generates inefficient JS (d2ebac3)
  • rendering: add css containment (5ad7fd1)
  • ripple: prevents jank by using raf (66bbd24)
  • scroll: efficient scroll events and properties (c377236)
  • tabs: improve tab switching response (907191b)
  • tap-click: tapPolyfill is only used in UIWebView! (0c61c2a)
  • virtual-scroll: improve virtual-scroll performance (b70d13d)



  • Renamed the no-shadow attribute for Material Design header, footer, and tabs to no-border. This is the same attribute used by iOS mode.

  • Moved the border on iOS from each toolbar to the last toolbar in a header, and the first toolbar in a footer. Adding no-border to the header or footer will hide the border.

    For example, the following code:

      <ion-navbar no-border-bottom></ion-navbar>
      <ion-toolbar no-border-top></ion-toolbar>

    will now become:


    and if you decide you don't want the border just add no-border to the header: <ion-header no-border>.

  • This means that no-border-top and no-border-bottom will not work on iOS and should be removed from any toolbars using it.


  • The argument passed to the events.subscribe(args) function is no longer an array of parameters. Instead, it will be called with the same parameters used in events.publish(arg1, arg2)

    For example, the following code:

  events.subscribe('user:created', args => {
    console.log('Welcome ', args[0], ' at ', args[1]);

will now become:

  events.subscribe('user:created', (user, time) => {
    console.log('Welcome ', user, ' at ', time);


November 17, 2016


Update the following dependencies in your package.json file:

"dependencies": {
  "@angular/common": "2.1.1",
  "@angular/compiler": "2.1.1",
  "@angular/compiler-cli": "2.1.1",
  "@angular/core": "2.1.1",
  "@angular/forms": "2.1.1",
  "@angular/http": "2.1.1",
  "@angular/platform-browser": "2.1.1",
  "@angular/platform-browser-dynamic": "2.1.1",
  "@angular/platform-server": "2.1.1",
  "@ionic/storage": "1.1.6",
  "ionic-angular": "2.0.0-rc.3",
  "ionic-native": "2.2.3",
  "ionicons": "3.0.0",
  "rxjs": "5.0.0-beta.12",
  "zone.js": "0.6.26"
"devDependencies": {
  "@ionic/app-scripts": "0.0.45",
   "typescript": "2.0.6"

Bug Fixes

  • animation: always run before classes and functions (d9e9ece), closes #8842 #8769
  • animation: fix regression in _willChg() (91f5087)
  • button: fix ios buttons in colored toolbar so they don't use the default color (0e53ec3), closes #8566
  • colors: override element styling and tweak colors for card and item (ee3decc), closes #9081
  • components: add a mode agnostic css class (#9133) (025c5cc), closes #8545
  • datetime: fix min/max displayFormat and pickerFormat (c72b67d), closes #8729
  • gestures: gesture controller handled by components (32ab817), closes #9046 #9130 #9052 #7444
  • item: fix color input for item divider and list header (5e5c33a), closes #8376
  • nav: controller is initialized (beab06f)
  • nav: fixes empty stack condition (909293a)
  • nav: it is not allowed to pop all the views (0ab990c)
  • nav: returning Promise in canLeave / canEnter works as expected (5f1a862)
  • nav: transitioning state is a boolean not a timer (63d495a)
  • nav: willLeave is called before willEnter (b77b2ae), closes #9163
  • nav: zIndex in overlays (70f8a8e)
  • picker: prevents scrolling under the picker (2348d22)
  • sass: change default font path (#8811) (0940d5a)
  • sass: remove usage of colors other than primary, improve error (#8907) (eb0b05d), closes #8266
  • styles: update ios and md styles closer to native (9f7972b)
  • typography: Exclude ion-item on a tags selector (#8340) (b00860b)


  • input: clearOnEdit feature. Closes #9187 (9469b4f)
  • nav: export NavControllerBase for building of components similar to ion-tab (24b087c)
  • tappable: auto add tappable attribute for ion-item clicks (5c4838b)
  • util: custom ionic error handler provider (6b77772)

Performance Improvements

  • animation: improves _progress() hot function (c44f6b6)
  • animation: optimizing hot loops (c78dc19)
  • animation: set after styles should not be recursive (3a2ff85)
  • click: increase number to find activatable elements (c8aad56), closes #9190
  • item: improve performance of sliding item (#9005) (759e3ea)
  • item: reorder is only added to the DOM if needed (dec5a0b), closes #9065
  • menu: avoid change detection when it isn't needed (#8986) (d531ec2)
  • nav: avoid running zone when it is not needed (be72d39)
  • picker: improves performance of picker and datepicker (fc2ee64)
  • picker: improves picker UX feedback (cfbc5ea)


November 3, 2016


Update the following dependencies in your package.json file:

"dependencies": {
  "@angular/common": "2.1.1",
  "@angular/compiler": "2.1.1",
  "@angular/compiler-cli": "2.1.1",
  "@angular/core": "2.1.1",
  "@angular/forms": "2.1.1",
  "@angular/http": "2.1.1",
  "@angular/platform-browser": "2.1.1",
  "@angular/platform-browser-dynamic": "2.1.1",
  "@angular/platform-server": "2.1.1",
  "@ionic/storage": "1.1.6",
  "ionic-angular": "2.0.0-rc.2"
"devDependencies": {
  "@ionic/app-scripts": "0.0.39"

Note: you should have other dependencies in this file that are not listed above, these are only the dependencies that need to be updated.

Remove the node_modules directory from your project, and then run npm install inside of your project. Then, you should be on the latest version!

Bug Fixes

  • action-sheet: Improve Action Sheet styles across all the platforms (#8736) (8d2c8b6), closes #8663
  • config: Cannot read property 'canDisableScroll' of undefined in unit tests (90f9b5c)
  • content: _scrollPadding is not undefined (6484c50), closes #8844
  • cordova: add Sass variables for md and wp statusbar padding (#8788) (8921cb1), closes #8712
  • directives: add missing export (#8999) (98d474b)
  • fab: only animate transform and opacity (f69e981)
  • input: wrong width of text-input for iOS (941e2d2), closes #7388
  • navigation: adds public willLoad lifecycle event (033e1ea)
  • navigation: clickblock is disabled longer (eb317d4), closes #8713
  • navigation: ion-nav inside ion-content work properly (ba557ac)
  • navigation: ionViewDidLoad fires before children components have been loaded (e89f3b0), closes #8449
  • navigation: swipe to go back gesture (04d61ee), closes #8919 #8958 #7934
  • navigation: is not overridden (8b65398), closes #8794
  • navigation: willLoad() does not have to be zone wrapped (17dbf69)
  • navigation: change detector exception (8b07e6c)
  • picker: fixes regression in picker but introduces new bug. (c1ba120)
  • range: fixes when step size is bigger than range (9895b86), closes #8830 #8802
  • range: range with long label renders correctly (f1f44eb)
  • refresher: only animate transform property (658c4d6)
  • sass: rename $background-color variable in our loops (2003ae4), closes #8475
  • scroll: fix scroll to top on iOS (2d165e1)
  • searchbar: looks good when mode is different (0c0f32d)
  • searchbar: positionElements to assign input mode fixes #8855 (cd0e19a)
  • searchbar: fix always hide button (316c4f3)
  • segment: update broken link (c66a440)
  • select: emit the ionSelect option when selecting an option (2eed5e2)
  • spinner: working in firefox and edge (ab93f3f), closes #8714
  • tabs: $tabs-md-tab-font-size is taken into account (4be5d83), closes #8820
  • tabs: regression in nav-controller-base (d84d8a6)
  • tap-click: several improvements (35d12ef)
  • templates: suffix templates page #8320 (#8368) (61620f8)
  • transition: syntax of cubic-bezier easing (813d945)
  • transition: wrong easing (09c08e9)


  • debug: add IonicErrorHandler (9397d6b)
  • tabs: tabsHideOnSubPages can be modified per tab (4f6a9b1)


October 13, 2016

Package.json Updates

package.json has been upated to include Angular dependencies and the latest version of app-scripts. Please update your package.json to reflect these changes and then run npm install.

  "dependencies": {
    "@angular/common": "2.0.0",
    "@angular/compiler": "2.0.0",
    "@angular/compiler-cli": "0.6.2",
    "@angular/core": "2.0.0",
    "@angular/forms": "2.0.0",
    "@angular/http": "2.0.0",
    "@angular/platform-browser": "2.0.0",
    "@angular/platform-browser-dynamic": "2.0.0",
    "@angular/platform-server": "2.0.0",
    "@ionic/storage": "1.0.3",
    "ionic-angular": "2.0.0-rc.1",
    "ionic-native": "2.2.3",
    "ionicons": "3.0.0",
    "rxjs": "5.0.0-beta.12",
    "zone.js": "0.6.21"
  "devDependencies": {
    "@ionic/app-scripts": "^0.0.36",
    "typescript": "^2.0.3"

Bug Fixes

  • content: move $text-ios-color to content (#8421) (91168af)
  • datetime-util: add missing date property conditions (2aea1cb)
  • demos: double quote in script tag (424b9e0)
  • fab: center fab list for larger buttons (267a77b)
  • fab: not using change detection (47e1e17), closes #8424
  • icon: isActive="false" with ios mode (bcbe03c), closes #8435
  • input: detect value when it is zero (d02e14c), closes #8019
  • input: text input width calculation (#8063) (21fa5cd)
  • item: regression in expandable sliding option button (695d25c), closes #8460
  • item: sliding item should not close when clicking an option button (ec6615d), closes #8481
  • item-divider: fabs have higher z-index than item-dividers (14e668c), closes #8489
  • list: consecutive inset lists with headers (93616c4), closes #8412 #6164
  • menu: backdrop click without 300ms delay (9bbe485), closes #6405
  • menu: console.debug statements are one line (a06bd69)
  • menu: menu's content is resized properly (db72a7d), closes #8504
  • modal: alerts do not trigger modal lifecycle events (e2704a4), closes #8616
  • modal: canEnter is called in modals (a40b42c)
  • nav: ionViewCanLeave does not break navigation (c8954d8), closes #8408
  • nav: ionViewDidLoad is called in modals (451ffe1), closes #8449
  • nav: push-pop pages too quickly (9b65022), closes #8319
  • nav: remove incorrectly used removeStart as a starting index in for loop. Fixes #8442 (6496c7a)
  • navbar: Don't fade out navbars. Fixes #8060 (eab5726)
  • popover: flipped arrow on iOS (#8462) (c996d85)
  • reorder: not trigger click event when reordering (9b2ae8a), closes #8362
  • reorder: several reorder lists in the same view (e75d9be)
  • ripple: always remove the activated class (d893441)
  • searchbar: autocomplete, autocorrect and type works again (7e63650), closes #7744
  • searchbar: clear button makes keyboard dismissal fail on iOS (6aaa601), closes #7527
  • searchbar: ENTER does not clear when it is inside a form (2e1bb4b), closes #7010
  • segment: add missing input (0052480), closes #8371
  • spinner: add input mode fix #8598 (8ee895f)
  • spinner: works in iOS8 (a2ffa63), closes #8145
  • tabs: add TabHighlight to IONIC_DIRECTIVES (ac88547), closes #8294
  • tabs: remove from parent nav when destroyed (5156917)
  • tap-click: null is not an object when scrolling after focusing an input on iOS (21eae2e), closes #7964
  • transition: ios-transition can be used in MD/WP (fcc515f), closes #7171
  • view-controller: dismiss does not crash when called more than once (d5f71a4), closes #8395
  • view-controller: avoid deep copy in dismiss() that can turn into an infinite loop (9227310)
  • virtual-scroll: set this.approxItemHeight before update(true) is called first (#8350) (b16228b)


  • events: handler argument is optional in unsubscribe() (8878e70), closes #8235
  • haptic: add haptic/taptic support to toggle/range/picker (713e2a1)
  • infinite-scroll: it can be enabled/disabled from a ng input (#8385) (fd5cdf0), closes #8380

Performance Improvements

  • searchbar: searchbar animation is disabled by default (d03182e), closes #6023


Angular has been updated to 2.0.0-rc.1, follow these steps to update Angular.

  1. Edit your package.json and remove the angular2 entry:

    "angular2": "2.0.0-beta.15"
  2. Then, run the following command from a terminal to update Ionic and Angular, or take a look at the starter's package.json changes and update each version:

    npm install --save ionic-angular@2.0.0-beta.7 @angular/core @angular/compiler @angular/common @angular/platform-browser @angular/platform-browser-dynamic @angular/router @angular/http rxjs@5.0.0-beta.6 zone.js@0.6.12 reflect-metadata
  3. Run the following command from a terminal to update the gulp task for ionic-gulp-scripts-copy:

    npm install --save-dev ionic-gulp-scripts-copy@2.0.0
  4. Then, change any imports in your application from angular2 to @angular. For example, the following:

    import {ViewChild} from 'angular2/core';
    import {Http} from 'angular2/http';


    import {ViewChild} from '@angular/core';
    import {Http} from '@angular/http';
  5. Remove the import for angular2-polyfills in index.html:

    <script src="build/js/angular2-polyfills.js"></script>

    and replace it with the following scripts:

    <script src="build/js/zone.js"></script>
    <script src="build/js/Reflect.js"></script>
  6. Replace all template variables in ngFor with let. For example:

    *ngFor="#session of group.sessions"


    *ngFor="let session of group.sessions"
  7. Replace all template variables in virtualScroll. For example:



    *virtualItem="let item"
  8. View the Angular Changelog for more in depth changes.

IonicApp (df32836) references #6199

The getComponent method of IonicApp has been removed. Please use Angular's ViewChild instead.

For example, the following:

<ion-nav id="nav" [root]="rootPage" #content></ion-nav>
import {IonicApp} from 'ionic-angular';

  templateUrl: 'build/app.html'
class MyApp {
  constructor(private app: IonicApp) {}

  setPage() {
    let nav ='nav');

Should be changed (in TypeScript) to use the Nav ViewChild:

<ion-nav [root]="rootPage" #content></ion-nav>
import {ViewChild} from '@angular/core';
import {Nav} from 'ionic-angular';

  templateUrl: 'build/app.html'
class MyApp {
  @ViewChild(Nav) nav: Nav;

  constructor() {}

  setPage() {

and the same example (in JavaScript):

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

  templateUrl: 'build/app.html',
  queries: {
    nav: new ViewChild('content')
class MyApp {
  constructor() {}

  setPage() {

Please see the Ionic Conference App for more usage examples.


The Angular router is currently under heavy development and refactoring. As a result of this, Angular’s router is currently disabled within Ionic. If your app requires use of the router we recommend waiting until a future release of Ionic when Angular has completed work on the new router. However, this does not affect Ionic’s navigation system and it continues to work with the same API from previous versions.

Sass Changes

Toolbar #6364

iOS Mode

  • $toolbar-ios-button-color now has a default value of color-contrast($colors-ios, $toolbar-ios-background, ios) which will evaluate to the primary color for light background toolbars and white for dark background toolbars.

  • $bar-button-ios-color has been renamed to $toolbar-ios-button-color

  • $bar-button-ios-border-radius has been renamed to $toolbar-ios-button-border-radius

  • added variables for the toolbar ios title for easier styling:


Windows Mode

  • $bar-button-wp-color was renamed to $toolbar-wp-button-color
  • $bar-button-wp-border-radius was renamed to $toolbar-wp-button-border-radius
  • Added $toolbar-wp-title-text-color for better control of the title color
  • Removed $toolbar-wp-button-color from the default themes

Material Design Mode

  • $toolbar-md-button-color no longer gets passed to the function that sets the contrast color for toolbar buttons, but it can still be used to set the default button color.
  • $bar-button-md-color was renamed to $toolbar-md-button-color
  • $bar-button-md-border-radius was renamed to $toolbar-md-button-border-radius

Toggle, Checkbox, Radio (4c5dd0b), (e075ccd), (ab82d53) references #5925

Renamed Sass variables in toggle, checkbox, and radio. Changed the word media in component-mode-media-padding (for example) to item-left.


September 28, 2016

RC0 requires changes to the structure of your app. To get started updating your app see the Steps to Upgrade below.

  • Ionic 2 API finalized for 2.0.0 release
  • Angular 2.0.0 final!
  • ionViewCanEnter / ionViewCanLeave lifecycle events
  • Floating Action Button (FAB) lists
  • Ahead of Time (AoT) compiler ready
  • Components can now individually set a mode, which means an app can mix and match iOS / Material Design / Windows Platform modes if that’s desired
  • Typescript 2.0
  • @types support for third-party libraries
  • Move away from gulp (ionic-gulp-tasks) to npm scripts (ionic-app-scripts)
  • Use Rollup for bundling instead of browserify or webpack


  • Angular upgrade to 2.0.0
  • Renamed Lifecycle events.
  • Storage has been removed from ionic-angular and placed into a separate module, @ionic/storage. Starters have been updated to add this, make sure to add it to your package.json if you’re using the storage system. See more details here.
  • Nav transitions are queued. For more info on what this means for you see this section.
  • Removed Tabs preloadTabs ability. This is no longer needed with the Ahead of Time (AoT) compiler.
  • Icons in buttons require an attribute on the parent button in order to style them.
  • Platform and mode CSS classes have been moved from the <body> element to the <ion-app> element.
  • Select’s alertOptions input has been renamed to selectOptions. See more details here.
  • Colors should be passed in the color input on components, not added individually as an attribute on the component. See more details here.
  • buttons: <button> becomes <button ion-button>. See more details here and here.
  • Head link tags for CSS files are no longer dynamically updated, but one CSS file is imported. (Future build processes will narrow down the CSS file further to only include what’s used). See more details here.
  • The <scroll-content> element, which is internal to <ion-content>, has been renamed to <div class="scroll-content"> since it was neither a directive nor a web component.
  • <ion-fixed> has been removed, use <div ion-fixed> instead.
  • Sass: Changes to how Sass is imported. See more details here.
  • Typings: We have stopped using the typings tool and have migrated to npm @types. See more details here.
  • Components no longer get a CSS class added based on the component class name. This should be added using the Component selector. See the Steps to Upgrade for more information on this change.

Lifecycle Events Renamed

  • Renamed ionViewLoaded to ionViewDidLoad
  • Removed ionViewDidUnload
  • Removed fireOtherLifecycles from ViewController

Nav Transitions

Nav transitions are now queued. Meaning if you run:


Page1 will transition in, then immediately Page2 will transition in. There can never be two transitions happening at the same time.

Page transition promises can now possibly reject the returned promises. Used mainly for ionViewCanEnter and ionViewCanLeave.

Component Colors

Colors are no longer added directly to a component, they should instead be passed in the color attribute.

For example:

<ion-tabs primary>


<ion-tabs color="primary">

Or to bind an expression to color:

<ion-navbar [color]="barColor">
  templateUrl: 'build/pages/about/about.html'
export class AboutPage {
  barColor: string;

  constructor(private nav: NavController, platform: Platform) {
    this.barColor ='android') ? 'primary' : 'light';

Components with this property:

  • Badge
  • Button
  • Checkbox
  • Chip
  • FAB
  • Icon
  • Item (Item, Item Divider, List Header)
  • Label
  • Navbar
  • Radio
  • Searchbar
  • Segment
  • Spinner
  • Tabs
  • Toggle
  • Toolbar
  • Typography (headers, paragraphs, spans, etc.)

Reason for this change:

  • It was difficult to dynamically add colors to components, especially if the name of the color attribute was unknown in the template.
  • This change keeps the css flat since we aren’t chaining color attributes on components and instead we assign a class to the component which includes the color’s name.
  • This allows you to easily toggle a component between multiple colors.
  • Speeds up performance because we are no longer reading through all of the attributes to grab the color ones.

Select Changes

Select’s alertOptions input has been renamed to selectOptions. It now allows you to pass options for either the alert or action-sheet interface. Refer to their documentation for the options each of them accept.

New Behavior of Button

  • <button> becomes <button ion-button>
  • <a button> becomes <a ion-button>
  • <button ion-item> does not get the ion-button attribute
  • Buttons inside of <ion-item-options> do get the ion-button attribute
  • Removed the category attribute, this should be passed in ion-button instead.

Reason for this change:

  • It was difficult to have custom buttons since buttons automatically received the Ionic styles. The user can now take advantage of adding their own styling to a button if they want it to behave differently than the Ionic button. Keeping the <a> and <button> element and adding ion-button as an attribute gives us the ability to take advantage of the native functionality and built-in accessibility of native elements. If Ionic provided an <ion-button> we’d have to copy over all the possible attributes and events to the real nested button/link (type=submit, formnovalidate, value, autofocus, href, target, focus/blur, download, nofollow, ping, etc). Additionally, Angular does not have the "replace" directive where <ion-button> could be turned into <a ion-button>.
  • Since button was already being used as an attribute to the <a> element, this is more consistent between the two.
  • If a navPush or navPop directive is on an <a ion-button>, Ionic can automatically add the href attribute.
  • A few reasons why we didn’t create <ion-button>

New Behavior of Icons in Buttons

  1. Icon only buttons

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


    <button ion-button icon-only>
     <ion-icon name="rainy"></ion-icon>
  2. Icon left of text in a button

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


    <button ion-button icon-left>
     <ion-icon name="rainy"></ion-icon>
  3. Icon right of text in a button

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


    <button ion-button icon-right>
     <ion-icon name="rainy"></ion-icon>
  4. Item option buttons - the icon-left attribute should still be added to the <ion-item-options> container and not the button itself.

  5. menuToggle buttons should not get the icon-only attribute

Reason for this change: There was a noticeable performance decrease from us reading in each button to determine where icons were placed and how to style them. This change improves performance. This adds styling so that the buttons and icons will be padded a certain amount, but the user is free to leave these attributes off and style the components themselves.

Update CSS Link Tags

Ionic stylesheets are no longer dynamically loaded per platform. Instead there will be one CSS file to import. Note that future build processes will slim down the CSS file even further to only include component CSS actually used.

In the head of your index.html file, replace:

<!-- ionic dynamically decides which stylesheet to load -->
<link ios-href="build/css/app.ios.css" rel="stylesheet">
<link md-href="build/css/" rel="stylesheet">
<link wp-href="build/css/app.wp.css" rel="stylesheet">


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

Sass Import

The default configuration will be updated, but if your existing app is using Sass and importing Ionic Sass files directly you’ll need to update the includePaths of Node Sass.


Next, to include Ionic into your custom Sass file you’ll need to update the Ionic import to this:

@import "ionic.theme.default";


Any type definitions for third party libraries that are included via the typings tool and are included in the the typings.json file should be updated to use npm @types. An example of how this looks is:

npm install @types/lodash --save-dev --save-exact

Delete the typings.json file, and the typings directory.


The storage utilities have been moved outside of the framework to a separate library called @ionic/storage.

This library can be installed by executing the following command:

npm install @ionic/storage --save --save-exact

It must be included in the app's NgModule list of providers:

import { Storage } from '@ionic/storage';


  providers: [Storage]

It can then be injected into any class that needs access to it:

import { Storage } from '@ionic/storage';


export class MyAwesomePage {
  constructor(public storage: Storage) {

  ionViewDidEnter() {'myKey').then( (value:any) => {
      console.log('My value is:', value);

Deployment Changes

ionic-angular package includes es5 code with es2015 module import/exports, umd modules, and pure es2015 code. The package.json is set up using the main and module options to make this work seamlessly.

Steps to Upgrade to RC0

We are providing 2 ways to update your app with this release: Copying your Project to a New Project and Modifying your Existing Project. The first way will guide you through creating a new Ionic 2 project and copying your project files to it. This is the easiest way to update your app in our opinion. The second way will step through how to update your existing project. There are a lot of steps involved with this way, and we recommend viewing our conference app for any clarification if you choose this way. This is it! We don’t plan on making any more major API changes after this version.

Note: For details on NgModules you can read the Angular docs on them here

Copying your Project to a New Project

  1. Ensure that you're using npm version 3.x by running:

    npm --version

    If you are not running 3.x, the easiest way to update is to install the latest version of Node.js.

    You can also update npm by following these instructions.

  2. Install the latest Ionic CLI:

    Important: if you have installed the beta cli you should run npm uninstall -g ionic first. You need version 2.1.0 for this release. Check your cli version by running ionic -v in the command line.

    npm install -g ionic
  3. Create a new Ionic 2 RC0 app:

    ionic start --v2 myApp
  4. Copy/paste all of your pages from app/pages/ of your beta.11 app to src/pages/, providers from app/providers to src/providers, pipes from app/pipes to src/pipes and any custom components to src/components in the new RC0 app.

  5. Modify all templateUrl's to be relative to the .ts file. For example in app.component.ts the url should change from build/app.html to app.html and in a page referencing about.html from build/pages/about/about.html to about.html.

  6. Import and add each of your pages to the declarations array and the entryComponents array in src/app/app.module.ts.

  7. Import and add each of your custom components and pipes to the declarations array in src/app/app.module.ts.

  8. Import and add each of your providers to the providers array in src/app/app.module.ts.

  9. Remove any use of the providers, pipes and directives arrays in @Component.

  10. Change any uses of the private TypeScript keyword to public ONLY for component variables that are needed in the associated template.

    Note: For details as to why this change has to be made, there is a discussion about it here.

  11. Change <button> to <button ion-button> according to these instructions.

  12. Pass colors to the color attribute : <button primary> changes to <button color="primary">. See component colors above.

  13. Move any Ionic config to the IonicModule.forRoot in app.module.ts. For example, the config should go where it says configObject here: IonicModule.forRoot(MyApp, {configObject}).

  14. Move any variables from the mode specific sass files in your beta.11 app into the theme/variables.scss file under each comment section for the specific mode in the new RC0 app: ios section, md section, wp section.

  15. Add selectors to each of your components that you would like to add custom styling for. These element selectors will be used for scoped sass. Previously a CSS class was dynamically added with the component class name, this is now the proper way to scope your sass for an individual page. For example, adding the page-about selector:

    In your component's stylesheet:

    page-about {
    #title {
      color: blue;

    In your component:

    selector: 'page-about',
    templateUrl: 'about.html'

Modifying your Existing Project

  1. Ensure that you're using npm version 3.x by running:

    npm --version

    If you are not running 3.x, the easiest way to update is to install the latest version of Node.js.

    You can also update npm by following these instructions.

  2. Install the latest Ionic CLI:

    Important: if you have installed the beta cli you should run npm uninstall -g ionic first. You need version 2.1.0 for this release. Check your cli version by running ionic -v in the command line.

    npm install -g ionic
  3. Update package.json dependencies and devDependencies to match the ionic2-app-base package.json, and then run npm install in your project folder.

  4. Copy the npm scripts from the ionic2-app-base package.json to your package.json.

  5. Delete the gulpfile.js.

  6. Rename the app folder to src.

  7. Create a new directory called app inside of src.

  8. Move the app.html and app.ts files inside of src/app.

  9. Rename app.ts to app.component.ts.

  10. Add an app.module.ts file and copy content from ionic2-starter-blank.

  11. Move any providers from ionicBootstrap in your app.component.ts file to the providers in app.module.ts. Make sure to copy imports, too.

  12. Import and add any of your custom components to the declarations array in src/app/app.module.ts.

  13. Move any Ionic config to the IonicModule.forRoot in app.module.ts. For example, the config should go where it says configObject here: IonicModule.forRoot(MyApp, {configObject}).

  14. Remove the ionicBootstrap code from app.component.ts.

  15. Export the main app class in app.component.ts and then rename all uses of MyApp in app.module.ts to your main app class (or rename the export to MyApp in app.component.ts).

  16. Fix any imports in app.component.ts to use the correct path. For example, ./pages becomes ../pages.

  17. Modify app.module.ts to import your page specific classes. See HomePage, for example. All pages should be included here.

  18. Fix any import paths in app.module.ts. For example, ./providers becomes ../providers.

  19. Add and files from ionic2-app-base to app/.

  20. Move www/index.html to src/index.html and modify it to look like ionic2-app-base, make sure to keep any external scripts you have added.

  21. Move www/assets to src/assets.

  22. Move www/img to src/assets/img.

  23. Move any other resources you have in www/ to src/assets/.

  24. Modify all templateUrl's to be relative to the .ts file. For example in app.component.ts the url should change from build/app.html to app.html and in a page referencing about.html from build/pages/about/about.html to about.html.

  25. Update .gitignore to match ionic2-app-base.

  26. Delete the typings/ folder and typings.json file.

  27. Update tsconfig.json to match ionic2-app-base.

  28. Rename and relocate app/theme/app.variables.scss to src/theme/variables.scss.

  29. Move app Sass rule files from app/theme to src/app. This includes app.core.scss, app.ios.scss, etc.

  30. Move any variables from the mode specific sass files in your beta.11 app into the theme/variables.scss file under each comment section for the specific mode in the new RC0 app: ios section, md section, wp section.

  31. Fix any paths to images in your app. For example, before the path may look like <img src="img/myImg.png"> and now it should be <img src="assets/img/myImg.png">.

  32. Change any uses of the private TypeScript keyword to public ONLY for component variables that are needed in the associated template.

    Note: For details as to why this change has to be made, there is a discussion about it here.

  33. Change any Ionic buttons from <button> to <button ion-button>. See New Behavior of Button.

  34. Pass colors to the color attribute: <button primary> changes to <button color="primary">.

  35. Add appropriate icon attributes, if the icon is on the left of the text in a button it should get icon-left, if the icon is on the right add icon-right, and if the button only has an icon in it, add the icon-only attribute to the button. See New Behavior of Icons in Buttons.

  36. Add selectors to each of your components that you would like to add custom styling for. These element selectors will be used for scoped sass. Previously a CSS class was dynamically added with the component class name, this is now the proper way to scope your sass for an individual page. For example, adding the page-about selector:

    In your component's stylesheet:

    page-about {
    #title {
      color: blue;

    In your component:

    selector: 'page-about',
    templateUrl: 'about.html'
  37. Remove any use of the providers, pipes and directives arrays in @Component.

Bug Fixes

  • action-sheet: add icon-left to the button if an icon exists (a731528)
  • animation: prevent possible raf null errors (0e8ebe5)
  • app: corrected paths to theme from app.scss (001c1c9)
  • checkbox: disabled toggle should not fire events or animate (3324e32)
  • di: update dependency injection and default configs (7c05d0c)
  • exports: update module exports (6784f5e)
  • fab: colors in speed dial buttons (b70614b)
  • gestures: fixes scroll issue with hammer config (174efc1), closes #6897
  • ion-fixed: ion-fixed directive is not longer needed (75d5526)
  • item: regression in sliding item introduced by 52ada1c (e0c2129)
  • item: sliding item events are zone wrapped (47491fb), closes #7630
  • item: sliding item with icon-only buttons (1d3d5a1)
  • menu: open/close race condition (8585427), closes #7629 #8001
  • nav: move null assignment of _onWillDismiss (35193c4)
  • nav: setRoot() and setPages() should not animate (7012734)
  • nav: move onWillDismiss and onDidDismiss, add unit tests (e26c425)
  • platform: fire platform ready on app init (963e835)
  • reorder: adjust reorder icon style for iOS and MD (f3bb2dc)
  • templates: add template tabs #8207 (#8208) (0f6ce28)
  • urlSerializer: improve findLinkByComponentData (9d563f5)

Code Refactoring

  • button: add ion-button attribute and icon attributes to style buttons (938864e), closes #7466
  • colors: color should be added as an input instead of directly adding the color to the component (55a0257), closes #7087 #7401 #7523
  • select: rename alertOptions to selectOptions, add ability to pass them for action-sheet (b8285b7), closes #7764


  • action-sheet: add ability to pass multiple classes to cssClass (68ab261)
  • chips: added Chip component (421f637)
  • chips: finished Component (0dece72)
  • fab: update floating action buttons (490a06d)
  • reorder: animate reorder button (1f78487)
  • loading: add ability to pass multiple classes to cssClass (466dea3)
  • loading: add setContent function (c750847)
  • add polyfill task (ce78194)
  • nav: component url navigation (f477aa2)
  • nav: set default stack history on app init (ca8cc0a)
  • polyfills: split up code and source polyfill task (#8130) (bcec66c)
  • popover: add ability to pass multiple classes to cssClass (a685cdc)
  • toast: add ability to pass multiple classes to cssClass (79e25a3)

Performance Improvements

  • item: apply will-change only when list is active (4bcd815)
  • reorder: reorder icon is display: none by default (26441ec)
  • ripple: md ripple effect update to not affect layout (14a3ea2)


August 5, 2016



  • Overlay components, such as Alert or Modals, should now be created using its injected provider.

  • Overlays now have the present() method on the overlay’s instance, rather than using nav.present(overlayInstance).

  • All overlays now present on top of all app content, to include menus.

  • Below is an example of the change to Alert, but the pattern is the same for all overlays: ActionSheet, Loading, Modal, Picker, Popover, Toast


    import { NavController, Alert } from ‘ionic-angular’;
    constructor(public nav: NavController) {
    doAlert() {
      let alert = Alert.create({
         title: 'Alert',


    import { AlertController } from ‘ionic-angular’;
    constructor(public alertCtrl: AlertController) {
    doAlert() {
      let alert = this.alertCtrl.create({
        title: 'Alert'

Select / Option #7334

The Option component’s checked attribute has been renamed to selected in order to make an option selected. This follows the MDN spec for a select option:

If a ngModel is added to the Select component the value of the ngModel will take precedence over the selected attribute.

See the Select and Option documentation for usage examples.

Tab Input/Config #7143

Tab input/config options have been renamed. The following options were renamed:

  • tabbarHighlight -> tabsHighlight
  • tabbarLayout -> tabsLayout
  • tabSubPages -> tabsHideOnSubPages
  • tabbarPlacement -> tabsPlacement

The previous names have been deprecated. They will still work in the current release but will be removed in the future so please update to the new names.

Material Design Tabs #7455

Material Design mode defaults have changed to the following:

tabsHighlight: false,
tabsPlacement: 'bottom',
tabsHideOnSubPages: false

tabsHighlight can now be passed as an attribute on the ion-tabs element, this allows for tabs to be added in multiple places inside of an app and enable the highlight on some of them.

Styling of the Material Design tabs reflects the spec for bottom navigation:

To get the old style of tabs, override the config in your bootstrap, for example:

ionicBootstrap(ConferenceApp, [ConferenceData, UserData], {
  platforms: {
    android: {
      tabsPlacement: 'top',
      tabsHideOnSubPages: true,
      tabsHighlight: true

And optionally override any of the Sass variables for md mode in theme/

$tabs-md-tab-text-capitalization: uppercase;
$tabs-md-tab-font-weight: 500;
$tabs-md-tab-text-transform: scale(1);

For a searchable list of all of the Sass variables, see the theming documentation:

Input Highlight #6449

Fixed typos in the input highlight variables:

  • $text-input-md-hightlight-color-valid -> $text-input-md-highlight-color-valid
  • $text-input-wp-hightlight-color-valid -> $text-input-wp-highlight-color-valid

Modified variables to turn on/off the highlight:

ios (defaults to false for all):

$text-input-ios-show-focus-highlight: false !default;
$text-input-ios-show-valid-highlight: $text-input-ios-show-focus-highlight !default;
$text-input-ios-show-invalid-highlight: $text-input-ios-show-focus-highlight !default;

md (defaults to true for all):

$text-input-md-show-focus-highlight: true !default;
$text-input-md-show-valid-highlight: $text-input-md-show-focus-highlight !default;
$text-input-md-show-invalid-highlight: $text-input-md-show-focus-highlight !default;

wp (defaults to true for all):

$text-input-wp-show-focus-highlight: true !default;
$text-input-wp-show-valid-highlight: $text-input-wp-show-focus-highlight !default;
$text-input-wp-show-invalid-highlight: $text-input-wp-show-focus-highlight !default;

Steps to Upgrade to Beta 11

  1. Run the following command in a terminal to update the npm dependencies:

    npm install --save --save-exact ionic-angular@2.0.0-beta.11 @angular/common@2.0.0-rc.4 @angular/compiler@2.0.0-rc.4 @angular/core@2.0.0-rc.4 @angular/http@2.0.0-rc.4 @angular/platform-browser@2.0.0-rc.4 @angular/platform-browser-dynamic@2.0.0-rc.4 @angular/forms@0.2.0 rxjs@5.0.0-beta.6 zone.js@0.6.12
  2. Update all Overlay components to be presented by their controller instead of NavController. For example, to update the popover component, the following code:

    constructor(private nav: NavController) {}
    presentPopover(event) {
     let popover = Popover.create(PopoverPage);
     this.nav.present(popover, { ev: event });


    constructor(private popoverCtrl: PopoverController) {}
    presentPopover(event) {
     let popover = this.popoverCtrl.create(PopoverPage);
     popover.present({ ev: event });
  3. Update any uses of ViewController.onDismiss to ViewController.onDidDismiss. The following code on dismiss of a modal:

    modal.onDismiss(() => {


    modal.onDidDismiss(() => {
  4. Update any uses of checked on an <ion-option> to use selected.

  5. If you are using any of the tab config variables, update them to reflect the new names above.

  6. If you are using any of the Sass Variables to override tabs or input highlights, update them to reflect the new names above.

  7. Please see the Ionic Conference App for an example of upgrading to Beta 11.

Bug Fixes

  • activator: do not activate elements while scrolling (845a516), closes #7141
  • animation: ele as string selector (9fa31a1)
  • animation: fix easing timing function (0cb093e), closes #7130
  • app: add status bar padding when tab subpages are hidden (d01ee4b), closes #7203
  • backdrop: flicker in UIWebView (44ab527)
  • backdrop: use raf when adding/removing disable-scroll css (941cb1d)
  • bootstrap: return promise and resolve ionicBootstrap (aebdf2f), closes #7145
  • bootstrap: tapclick is injected, probably (7358072)
  • button: apply css for buttons w/ ngIf (816a648), closes #5927
  • button: outline buttons do not have hairline borders in iOS (4e88f89)
  • datetime: format seconds token (4fff262), closes #6951
  • datetime-util: fix convertDataToISO to handle negative timezone offsets (ba53a23)
  • generator: change nav to navCtrl (b19547c)
  • gestures: detecting swipe angle correctly + sliding item logic fix (d230cb4)
  • input: add input highlight for ios, fix the highlight size (11a24b9), closes #6449
  • item: sliding item is closed when tapped (7aa559a), closes #7094
  • loading: clear timeout if dismissed before timeout fires (5bbe31a)
  • loading: fix loading overlay during app init (b615c60), closes #6209
  • menu: add statusbarPadding to the header and content in a menu (a468fde), closes #7385
  • menu: fix content going under header (3cd31c3), closes #7084
  • menu: getBackdropElement (cac1d4f)
  • menu: only one menu can be opened at a time (cac378f), closes #6826
  • menu: swipe menu is triggered when the swipe |angle| < 40º (32a70a6)
  • nav: fire lifecycle events from app root portal (a4e393b)
  • nav: fix menuCtrl reference in swipe back (55a5e83)
  • nav: register child nav when created from modal (61a8625)
  • picker: fix iOS 8 picker display (86fd8a4), closes #7319
  • popover: remove min-height from ios, add sass variables (55bc32d), closes #7215
  • range: add mouse listeners to document (267ced6)
  • range: align the label in an item range to the center (d675d39), closes #7046
  • range: ion-label stacked with ion-range (5a8fe82), closes #7046
  • range: set ticks to an empty array to prevent errors (7a2ad99)
  • reorder: better style (f289ac6)
  • reorder: canceled reorder is animated smoothly back (8483a43)
  • reorder: non ion-item elements can be reordered (ea9dd02), closes #7339
  • reorder: reorder can be used with any element (d993a1b)
  • scroll: fix scrolling after switching tabs (e4bbcc6), closes #7154
  • select: add the cssClass passed by the user to the alert for a select (81ddd7f), closes #6835
  • slides: delay loading slides until view ready (580b8d5), closes #7089
  • sliding: much better UX + performance (d6f62bc), closes #6913 #6958
  • tabs: add sass variable for inactive opacity and pass it to the colors loop (99efa36)
  • tabs: center tabbar content (997d54e)
  • tabs: fix preloadTabs null element reference (2d19308), closes #7109
  • tabs: make the text color opaque instead of the entire button (dd969a2), closes #6638
  • util: UIEventManager should handle touchcancel event (b805602)


  • alert: allow smooth overflow scrolling (5542a93)
  • content: add a resize function to recalculate the content size (1fe1c1e)
  • footer: apply shadow on MD footer and tabbar bottom (686c262)
  • gesture: Introducing new gesture controller (9f19023)
  • gesture-controller: disable/enable scrolling (72c24bc)
  • header: apply shadow on MD headers (6fa2faf)
  • ion-content: iOS only scroll bounce (5c80445)
  • select: add disabled status in select options (76619cf)
  • tabs: apply shadow on MD tabbar top (1f4b3e2)
  • tabs: add the transition for material design tabs (eea7e6b)
  • toolbar: add attributes to hide all borders and box shadows (88b637b), closes #7237
  • viewcontroller: add onWillDismiss callback (ec99bfd), closes #6702

Performance Improvements

  • animation: using will-change when using progressStep() (267aa32)
  • menu: several improvements (86c5aaf)


June 27, 2016


  • ion-content now takes up 100% of the viewport height, but it has margin added to the top and bottom to adjust for headers, footers, and tabs.

  • ion-content now accepts fullscreen as an attribute to to tell the content to scroll behind the header. This allows for transparent toolbars and tab pages without navbars!

  • ion-navbar no longer has the *navbar attribute.

  • ion-navbar should now be wrapped in an ion-header

  • ios only: ion-toolbar/ion-navbar will always have borders to both the top and bottom of the element. Use the attributes no-border-top and no-border-bottom to remove the respective borders.

  • An ion-nav or ion-tabs is required in the root component. If one of these does not exist your content may be pushed up behind your header.

  • The position attribute has been removed from the ion-toolbar, it should now be placed in an ion-header or an ion-footer. It can also be placed inside of an ion-content.

  • The only elements that should be children of a page are ion-header, ion-content, and ion-footer.

Steps to Upgrade to Beta 10

  1. Run the following command from your command prompt/terminal to update to the latest version of the Ionic framework 2:

    npm install --save ionic-angular@2.0.0-beta.10 @angular/common@2.0.0-rc.3 @angular/compiler@2.0.0-rc.3 @angular/platform-browser@2.0.0-rc.3 @angular/platform-browser-dynamic@2.0.0-rc.3 @angular/http@2.0.0-rc.3 @angular/core@2.0.0-rc.3  @angular/router@2.0.0-rc.2
  2. Remove the *navbar attribute so this:

    <ion-navbar *navbar>

    becomes this:

  3. Wrap any toolbars/navbars above the ion-content in an ion-header. The following:

       Navbar Title
       Toolbar Title


         Navbar Title
         Toolbar Title
  4. Wrap any toolbars/navbars after the ion-content in an ion-footer. The following:

    <ion-toolbar position="bottom">
     <ion-title>Footer Toolbar</ion-title>


       <ion-title>Footer Toolbar</ion-title>

Bug Fixes

  • animation: correctly apply will-change: transform (a1223da)
  • bootstrap: only add customProviders when present (0e9e85c)
  • content: adjust footer bottom based on the tabbar without padding (4567de2)
  • content: set footer height to 0 so it won't be undefined (3db67f9)
  • cordova: fix the status bar padding with the new structure (15642e4)
  • demos: updates @angular paths (b7826ba)
  • footer: show footer toolbar w/ tabbar bottom (99c50a1)
  • generator: fix closing tag for header (47e09a1)
  • header: optional ViewController injection (5a85d82)
  • input: allow button click when input has focus (ae86ab8), closes #6514 #6944
  • input: check if there is a value when setting value (d0b1930)
  • input: fix the clear input button to always be vertically aligned (e4cc672)
  • item: inherit overflow and text-overflow from the parent item in a paragraph (4009575)
  • item: listEle does not longer exist (22fad4c)
  • item: sliding item works with and without borders (2303c16), closes #7081
  • item: sliding items don't fire (click) when swiped (38ab17b)
  • modal: add class name to modal (6e34739), closes #7000
  • nav: auto set iOS black transition bg via css (7842991)
  • picker: adds align to the PickerColumn interface (b8551de)
  • refresher: adjust location after layout updates (603000f)
  • refresher: only listen for mousemove/touchmove when needed (1a58a41)
  • tabs: don't add outline to the class name if it is a logo icon (af22287), closes #6899
  • tabs: fix tabs rootNav (ae40edf)
  • tabs: hide tab's navbar when a page comes without a navbar (2d68089), closes #5556
  • tabs: reference parent instead of parentTabs (ed6d0fa)
  • tabs: swipeBackEnabled works with tabs as expected (2bff535)
  • toggle: host listeners are not longer needed (4aa322d)
  • toolbar: place iOS border on ion-header/footer (48c1ffd)
  • toolbar: position toolbar relative and add z-index (1d8ba4a)
  • virtualScroll: first node should use clientTop/clientLeft (2197d49)


  • feature-detect: detect if backdrop-filter is supported (89564f1)
  • fullscreen: add fullscreen property to ion-content (f20c7e4)
  • item: sliding items work with list reorder (bfdc898)
  • list: add list headers and item dividers as items (712ff81), closes #5561
  • list: reorder list items (5c38921)
  • range: add debounce input for ionChange event (55eccb3), closes #6894
  • toolbar: control toolbar borders on top/bottom (3a7addf)

Performance Improvements

  • reorder: hit test refactored (6a52a4a)


June 16, 2016


Searchbar Refactored

  • Searchbar's events no longer emit the Searchbar itself, they now emit the input's $event for each native input event. Instead of grabbing the value from the searchbar, you should grab it from the event target. For example:

    Previously when an event was called the function called would look similar to this:

    getItems(searchbar) {
      // set q to the value of the searchbar input
      var q = searchbar.value;

    Now it should be similar to this:

    getItems(ev) {
      // set q to the value of the searchbar input
      var q =;
  • ngModel is no longer required on Searchbar, but it can still be used. You can get the value of the input through Searchbar's Output Events.

  • Added the ability to pass autocomplete, autocorrect, spellcheck, and type to the searchbar which is passed to the input.

  • The hideCancelButton attribute was removed in favor of showCancelButton which is set to false by default.


  • backButton: register back button actions (84f37cf)
  • item: add the ability to show a forward arrow on md and wp modes (c41f24d)
  • item: two-way sliding of items (c28aa53), closes #5073
  • item-sliding: two-way item sliding gestures (5d873ff)
  • modal: background click and escape key dismiss (#6831) (e5473b6), closes #6738
  • navPop: add nav pop method on the app instance (9f293e8)
  • popover: background dismiss, escape dismiss (1d78f78), closes #6817
  • range: range can be disabled (ccd926b)
  • select: add placeholder as an input for select (461ba11), closes #6862
  • tabs: track tab selecting history, create previousTab() method (d98f3c9)

Bug Fixes

  • button: check for icon and add css after content checked (f7b2ea2), closes #6662
  • click-block: click block is now showing on all screns. (761a1f6)
  • click-block: fix for the click block logic (9b78aeb)
  • datetime: add styling for datetime with different labels (adcd2fc), closes #6764
  • decorators: change to match angular style guide (9315c68)
  • item: change ion-item-swiping to use .item-wrapper css instead (31f62e7)
  • item: encode hex value in the detail arrow so it works on firefox (03986d4), closes #6830
  • item: improve open/close logic, update demos (db9fa7e)
  • item: item-options width calculated correctly (64af0c8)
  • item: sliding item supports dynamic options + tests (14d29e6), closes #5192
  • item: sliding item's width must be 100% (efcdd20)
  • menu: push/overlay working correctly in landscape (0c88589)
  • menu: swiping menu distinguishes between opening and closing direction (29791f8), closes #5511
  • Menu: fix right overlay menu when rotating device (07d55c5)
  • modal: add status bar padding to modal (181129b)
  • modal: change modal display so you can scroll the entire height (01bbc94), closes #6839
  • navigation: keep the click block up longer if the keyboard is open (#6884) (d6b7d5d)
  • popover: allow target element to be positioned at left:0 (ea450d4), closes #6896
  • popover: hide arrow if no event was passed (8350df0), closes #6796
  • range: bar height for ios should be 1px, add disabled for wp (f2a9f2d)
  • range: stop sliding after releasing mouse outside the window (9b2e934), closes #6802
  • scrollView: ensure scroll element exists for event listeners (1188730)
  • searchbar: add opacity so the searchbar doesn't show when it's moved over (b5f93f9)
  • searchbar: only trigger the input event on clear if there is a value (99fdcc0), closes #6382
  • searchbar: position elements when the value changes not after content checked (31c7e59)
  • searchbar: set a negative tabindex for the cancel button (614ace4)
  • searchbar: use the contrast color for the background in a toolbar (b4028c6), closes #6379
  • tabs: reduce padding on tabs for ios (fd9cdc7), closes #6679
  • tap: export isActivatable as a const so its transpiled correctly (ce3da97)
  • toast: close toasts when two or more are open (#6814) (8ff2476), closes (#6814
  • toast: toast will now be enabled (#6904) (c068828)
  • virtualScroll: detect changes in individual nodes (f049521), closes #6137

Performance Improvements

  • virtualScroll: improve UIWebView virtual scroll (ff1daa6)


June 6, 2016


Ionic Decorators Removed

We’ve started the process of optimizing Ionic 2 to improve our support for Progressive Web Apps and upcoming Angular tooling. Because of this, we have removed the Ionic decorators in favor of using Angular's Component decorator. The following changes need to be made. For a step by step guide, see the Steps to Upgrade to Beta 8 section.

  • @App and @Page should be replaced with @Component.
  • IonicApp has been renamed to App.
  • ionicBootstrap is required to bootstrap the app.
  • Config is now the 3rd parameter in ionicBootstrap(rootComponent, providers, config).
  • Property prodMode is now a config option, enabling or disabling production mode.

Ionic Lifecycle Events Renamed

All Ionic lifecycle events have been renamed from starting with onPage to starting with ionView. These changes were made to make it more clear that the events belong to Ionic on each view.

  • onPageLoaded renamed to ionViewLoaded
  • onPageWillEnter renamed to ionViewWillEnter
  • onPageDidEnter renamed to ionViewDidEnter
  • onPageWillLeave renamed to ionViewWillLeave
  • onPageDidLeave renamed to ionViewDidLeave
  • onPageWillUnload renamed to ionViewWillUnload
  • onPageDidUnload renamed to ionViewDidUnload

Ionic Component Events Renamed

All Ionic component events have been renamed to start with ion. This is to prevent the Ionic events from clashing with native HTML events.

  • Checkbox
    • change -> ionChange
  • DateTime
    • change -> ionChange
    • cancel -> ionCancel
  • InfiniteScroll
    • infinite -> ionInfinite
  • Menu
    • opening -> ionDrag
    • opened -> ionOpen
    • closed -> ionClose
  • Option
    • select -> ionSelect
  • Picker
    • change -> ionChange
  • RadioButton
    • select -> ionSelect
  • RadioGroup
    • change -> ionChange
  • Refresher
    • refresh -> ionRefresh
    • pulling -> ionPull
    • start -> ionStart
  • Searchbar
    • input -> ionInput
    • blur -> ionBlur
    • focus -> ionFocus
    • cancel -> ionCancel
    • clear -> ionClear
  • Segment
    • change -> ionChange
    • select -> ionSelect
  • Select
    • change -> ionChange
    • cancel -> ionCancel
  • Slides
    • willChange -> ionWillChange
    • didChange -> ionDidChange
    • move -> ionDrag
  • TabButton
    • select -> ionSelect
  • Tab
    • select -> ionSelect
  • Tabs
    • change -> ionChange
  • Toggle
    • change -> ionChange

Steps to Upgrade to Beta 8

  1. Upgrade to Beta 8 by running the following command:

    npm install --save ionic-angular@2.0.0-beta.8

    or modify the following line to use beta.8 in your package.json and then run npm install:

    "ionic-angular": "^2.0.0-beta.8",

    This is the way to update Ionic to any version, more information can be found in the docs.

  2. Replace all instances of @Page with @Component:

    import {Page} from 'ionic-angular';


    import {Component} from '@angular/core';
  3. Replace @App with @Component and then bootstrap it. Move any config properties into the bootstrap:

    import {App, Platform} from 'ionic-angular';
     templateUrl: 'build/app.html',
     providers: [ConferenceData, UserData],
     config: {
       tabbarPlacement: 'bottom'
    export class MyApp {


    import {Component} from '@angular/core';
    import {ionicBootstrap, Platform} from 'ionic-angular';
     templateUrl: 'build/app.html',
    export class MyApp {
    // Pass the main app component as the first argument
    // Pass any providers for your app in the second argument
    // Set any config for your app as the third argument:
    ionicBootstrap(MyApp, [ConferenceData, UserData], {
     tabbarPlacement: 'bottom'
  4. Rename any uses of IonicApp to App:

    import {IonicApp} from 'ionic-angular';
     private app: IonicApp
    ) {


    import {App} from 'ionic-angular';
     private app: App
    ) {
  5. Rename any uses of the lifecycle events, for example:

    onPageDidEnter() {
     console.log("Entered page!");


    ionViewDidEnter() {
     console.log("Entered page!");

    The full list of lifecycle name changes is in the section above.

  6. Rename any Ionic events, for example:

    <ion-slides (slideChangeStart)="onSlideChangeStart($event)">


    <ion-slides (ionWillChange)="onSlideChangeStart($event)">

    The full list of event name changes is in the section above.

Bug Fixes

  • build: correct link in output.wp.scss file to old ionic directory. (6113daf)
  • button: style disabled anchor/button elements (d0abbaf), closes #6108
  • config: pass custom providers in the bootstrap of the app (c74b3f7)
  • config: set the properties for each mode and add defaults (7def98c), closes #6132
  • datetime: clear out existing datetime data (c1ad804), closes #6614
  • datetime: fix ISO format when w/out timezone data (272daf2), closes #6608
  • infiniteScroll: ensure infinite doesn't fire when already loading (f7b1f37)
  • input: add form validation classes to the item (5498a36)
  • input: fix material design success/error highlighting on inputs (702a882)
  • input: fix the clear input placement on wp mode (4ba999e)
  • input: pass the control classes down to the native input (6180cb8)
  • ion-backdrop: new ion-backdrop can prevent background scrolling (a1a582b), closes #6656
  • item: remove border for the last item in an item-group (6b3e7ac), closes #6518
  • label: make all ion-labels stacked or floating stretch (b742e1f), closes #6134
  • menu: fix swipe to go back and left menu conflict (f18a624), closes #5575
  • menu: pass platform to menu type (7f597a0)
  • modal: fix onPageWillEnter (01110af), closes #6597
  • picker: safari fired pointerEnd() twice (#6708) (170cf8c), closes #6704
  • picker: use sanitizer on translate3d css prop (8598a2e)
  • platform: pass original event in EventEmitter (cc93366)
  • popover: allow popover to have an ion-content wrapping it (c801d18)
  • popover: position MD popover on top of element clicked (6bd91f0), closes #6683
  • popover: style the ion-content background in a popover to match popover bg (9ea89ea)
  • range: fix styling on range, add demo (d24b080)
  • range: prevent change detection exception (7e4b13d)
  • range: update range left/right margin on ios (27fa22f)
  • range: update the styling for all modes (061af93)
  • ripple: do not activate ripple if pointer moved (d57833c)
  • slides: Removing a slide via *ngIf now properly removes the slide and the bullet from th (dbe54b5), closes #6651
  • toast: remove backdrop, allow user interaction when up (d4d1f70), closes #6291
  • toast: remove the enableBackdropDismiss option on toast (aeeae3f)
  • toggle: do not fire change when initializing (cd2afb3), closes #6144
  • transition: reduce transition delay on MD (908fa03)


  • alert: add Sass variables for the radio/checkbox labels when checked (9cc0dc7), closes #6289
  • item: add item-content attr selector (839adf8), closes #6643
  • menu: add opened/closed events (51ee8b7)
  • popover: add height auto for safari and remove ability to scroll on backdrop (620b7c8)
  • popover: add MD animation (1d0d755)
  • popover: add popover component (53fd3c3)
  • popover: add styling for the md pin (a25a552)
  • popover: adjust popover to position in the center with no event (1e7b572)
  • popover: change MD animation and use for WP also (44a7da8)
  • popover: change popover item background color to match wrapper (b0d71da)
  • popover: change template in popover to a page similar to modal (a96e36a)
  • popover: fix long popovers that go off the page (4db72cf)
  • popover: fix MD animations and start from the right side (e419ec6)
  • popover: modify the animation for each mode (57a1274)
  • popover: position popover in the top middle if no event (438a389)
  • popover: position the popover on transition instead of create (2cd1b51)
  • range: add ability to add labels to the left/right of range (fc819dd)
  • range: add md and wp styling, tweak ios styling (af6d5e4)
  • range: add styling for range-left/range-right md and wp (21753a8)
  • range: add styling for the range when knob is minimum md (c59c656)
  • range: create ion-range input (2c6e11b)
  • range: fix the knob on md so the transform isn't blurry (cffa84c)
  • range: only increase knob size when pin doesn't exist (47174df)


May 19, 2016


  • datetime: add ion-datetime (1e331c9)
  • input: added functionality for clear input option on ion-input (d8e2849)
  • modal: add inset modal feature (a658524), closes #5423
  • modal: start of inset modals (a1a594d)
  • picker: add ios/md/wp picker styles (aa9a667)
  • picker: init picker (d5068f8)
  • platform: add a readySource as ready resolved value (f68ac8a)
  • platform: cordova pause/resume events (532096b)

Bug Fixes

  • app: add status bar padding to navbar when a tab subpage (62b97ce), closes #6368
  • app: fix status bar padding for inset modals (4d27680)
  • build: fix e2e, demos, and karma tests to use new angular module setup. (4c19d15)
  • button: add the solid class to bar buttons (658b29b)
  • button: add transparent background for clear/outline windows buttons (da5c065)
  • button: exclude solid from getting added to the button in the class (4252448)
  • button: remove unnecessary ion-button-effect elements (369d78b)
  • checkbox: add ability to align checkboxes to the right (e075ccd), closes #5925
  • datetime: fix property dayNames (it was using dayShort) (0bd736d)
  • datetime: improve parseTemplate (55ec80a)
  • grid: add ion-grid element which wraps the rows/cols and adds padding (a0c0228)
  • input: clear text input (bde103d)
  • input: remove old clearInput code and clean up UI, added onChange calls (71cd297)
  • loading: include cssClass in the Loading options (4c8ee95), closes #6365
  • nav: transition toolbars on iOS (daa4ccc), closes #5692
  • picker: number of dom children != number of options (#6551) (28cf16a)
  • radio: add styling for radio when item-left/item-right is added (4c5dd0b)
  • raf: test for undefined raf (1c16008)
  • segment: add disabled property to segment and segment button (4fca31e)
  • select: add min height to select text for windows since it shows border (e9c1442)
  • show-hide-when: add !important to display as this should always take precedence (617b7ac), closes #6270
  • slides: make slide method parameters optional (f355087)
  • slides: set class using renderer instead of host (132d8e9), closes #6275
  • tabs: move border to top for windows positioned bottom tabs (af2085e), closes #6526
  • tabs: remove min-width from tab so 5 tabs will fit (b4647cd), closes #6056
  • toast: add toast back to the components export (d7d4742)
  • toggle: add styling for toggle when placed left (ab82d53)
  • toolbar: add the mode to the inverse function for a toolbar (3ca3027), closes #6364
  • toolbar: md mode use the color contrast for toolbar button/title (9f54f16)
  • toolbar: remove color change from outline buttons in toolbar (6759074)
  • toolbar: set the text color of the toolbar based on the contrast of the background (74afc18)
  • toolbar: wp get title/button color from the contrast of toolbar background (62bd13b)
  • virtual-scroll: fixes from rc1 breaking changes (158f717)