2136 lines (1602 sloc) 122 KB

2.0.0-rc.5 (2017-01-11)

Updating to 2.0.0-rc.5

  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.



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

2.0.0-rc.4 (2016-12-15)

Updating to 2.0.0-rc.4

  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);

2.0.0-rc.3 (2016-11-17)

Updating to 2.0.0-rc.3

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)

2.0.0-rc.2 (2016-11-03)

Updating to 2.0.0-rc.2

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)

2.0.0-rc.1 (2016-10-13)

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

2.0.0-rc.0 (2016-09-28)

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 2 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)

2.0.0-beta.11 (2016-08-05)



  • 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)

2.0.0-beta.10 (2016-06-27)


  • 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)

2.0.0-beta.9 (2016-06-16)


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)

2.0.0-beta.8 (2016-06-06)


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)

2.0.0-beta.7 (2016-05-19)


  • 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)


Angular Update to 2.0.0-rc.1

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.