3.2.1 (2017-05-12)

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

3.2.0 (2017-05-10)

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)

Features

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)

3.1.1 (2017-04-28)

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)

3.1.0 (2017-04-26)

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)

Features

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)

3.0.1 (2017-04-06)

Bug Fixes

scroll: fix scroll issues in UIWebView (26d10c4), closes #11081 #10976 #10966 #10936 #11051 #10889
tap-click: remove 300ms click delay (36bbcd9)
virtual-list: make it work with empty lists (eb9de60), closes #11093

3.0.0 (2017-04-05)

Steps to Upgrade to 3.0

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.

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"
}

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: [
  BrowserModule,
  IonicModule.forRoot(MyApp)
],

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: [
  BrowserModule,
  HttpModule,
  IonicModule.forRoot(MyApp)
],

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.

Blog Post: http://blog.ionic.io/ionic-native-3-x/
Example Upgrade Commit: https://github.com/driftyco/ionic-conference-app/commit/62088

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)

Features

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)

BREAKING CHANGES

Grid

Removed the deprecated (old) grid. See the blog post for more information including steps to migrate: http://blog.ionic.io/build-awesome-desktop-apps-with-ionics-new-responsive-grid/

Typography

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: http://ionicframework.com/docs/api/components/typography/Typography/

Slides

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.

2.3.0 (2017-03-22)

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)

Features

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)

2.2.0 (2017-03-08)

Updating to 2.2.0

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.

Angular 2.4.8

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

Features

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

2.1.0 (2017-02-23)

Bug Fixes

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

Features

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

2.0.1 (2017-02-08)

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

2.0.0 (2017-01-25)

Enjoy! 🎉

2.0.0-rc.6 (2017-01-24)

Updating to 2.0.0-rc.6

Update the framework:

npm install --save --save-exact ionic-angular@2.0.0-rc.6

Change the import for ionicons in your theme/variables.scss file from this:
```
@import "ionicons";
```
to
```
@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)

Features

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

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

Updating to 2.0.0-rc.5

Update to the latest version of the Ionic CLI:

npm uninstall -g ionic
npm install -g ionic

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.

BREAKING CHANGES

Inputs

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.

Slides

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

Update the Ionic CLI to the latest version:

npm uninstall -g ionic
npm install -g ionic

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"
}

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: https://github.com/driftyco/ionic-app-scripts/blob/master/CHANGELOG.md

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)

Features

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)

BREAKING CHANGES

Toolbar

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-header>
  <ion-navbar no-border-bottom></ion-navbar>
  <ion-toolbar no-border-top></ion-toolbar>
</ion-header>
```
will now become:
```
<ion-header>
  <ion-navbar></ion-navbar>
  <ion-toolbar></ion-toolbar>
</ion-header>
```
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.

Events

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)

Features

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: view.id 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 ionic-team/ionic-site#777 (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)

Features

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)

Features

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

BREAKING CHANGES

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:

navCtrl.push(Page1);
navCtrl.push(Page2);

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>

Becomes

<ion-tabs color="primary">

Or to bind an expression to color:

<ion-navbar [color]="barColor">
   ...
</ion-navbar>

@Component({
  templateUrl: 'build/pages/about/about.html'
})
export class AboutPage {
  barColor: string;

  constructor(private nav: NavController, platform: Platform) {
    this.barColor = platform.is('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.

ActionSheet
Alert

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

Icon only buttons

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

becomes

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

Icon left of text in a button

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

becomes

<button ion-button icon-left>
  <ion-icon name="rainy"></ion-icon>
  Rainy
</button>

Icon right of text in a button

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

becomes

<button ion-button icon-right>
  Rainy
  <ion-icon name="rainy"></ion-icon>
</button>

Item option buttons - the icon-left attribute should still be added to the <ion-item-options> container and not the button itself.
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/app.md.css" rel="stylesheet">
<link wp-href="build/css/app.wp.css" rel="stylesheet">

With:

<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.

node_modules/ionic-angular/themes

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

@import "ionic.theme.default";

Typings

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.

Storage

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

...

@NgModule({
  ...
  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() {

    this.storage.get('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

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.

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

Create a new Ionic 2 RC0 app:

ionic start --v2 myApp

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.
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.
Import and add each of your pages to the declarations array and the entryComponents array in src/app/app.module.ts.
Import and add each of your custom components and pipes to the declarations array in src/app/app.module.ts.
Import and add each of your providers to the providers array in src/app/app.module.ts.
Remove any use of the providers, pipes and directives arrays in @Component.
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.

Change <button> to <button ion-button> according to these instructions.
Pass colors to the color attribute : <button primary> changes to <button color="primary">. See component colors above.
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}).
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.
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:

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

Modifying your Existing Project

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.

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

Update package.json dependencies and devDependencies to match the ionic2-app-base package.json, and then run npm install in your project folder.
Copy the npm scripts from the ionic2-app-base package.json to your package.json.
Delete the gulpfile.js.
Rename the app folder to src.
Create a new directory called app inside of src.
Move the app.html and app.ts files inside of src/app.
Rename app.ts to app.component.ts.
Add an app.module.ts file and copy content from ionic2-starter-blank.
Move any providers from ionicBootstrap in your app.component.ts file to the providers in app.module.ts. Make sure to copy imports, too.
Import and add any of your custom components to the declarations array in src/app/app.module.ts.
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}).
Remove the ionicBootstrap code from app.component.ts.
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).
Fix any imports in app.component.ts to use the correct path. For example, ./pages becomes ../pages.
Modify app.module.ts to import your page specific classes. See HomePage, for example. All pages should be included here.
Fix any import paths in app.module.ts. For example, ./providers becomes ../providers.
Add main.dev.ts and main.prod.ts files from ionic2-app-base to app/.
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.
Move www/assets to src/assets.
Move www/img to src/assets/img.
Move any other resources you have in www/ to src/assets/.
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.
Update .gitignore to match ionic2-app-base.
Delete the typings/ folder and typings.json file.
Update tsconfig.json to match ionic2-app-base.
Rename and relocate app/theme/app.variables.scss to src/theme/variables.scss.
Move app Sass rule files from app/theme to src/app. This includes app.core.scss, app.ios.scss, etc.
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.
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">.
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.

Change any Ionic buttons from <button> to <button ion-button>. See New Behavior of Button.
Pass colors to the color attribute: <button primary> changes to <button color="primary">.
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.
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:

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

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

Features

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)

BREAKING CHANGES

Angular2 has been updated to RC4.
ViewController’s onDismiss has been renamed to onDidDismiss
Forms have been upgraded to @angular/forms - Angular2 Forms Changes.
Overlay components should now be created with their injected provider.
The Select Options checked attribute has been renamed to selected.
Tab’s input and config variables have been renamed.
Material Design tabs have been updated to resemble Material Design’s bottom navigation spec: https://material.google.com/components/bottom-navigation.html
Input highlight was added as an option for ios and wp mode, but defaults to false.
Please review the Steps to Upgrade below.

Overlays

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

WAS:

import { NavController, Alert } from ‘ionic-angular’;

constructor(public nav: NavController) {
}

doAlert() {
  let alert = Alert.create({
     title: 'Alert',
  });
  this.nav.present(alert);
}

NOW:

import { AlertController } from ‘ionic-angular’;

constructor(public alertCtrl: AlertController) {
}

doAlert() {
  let alert = this.alertCtrl.create({
    title: 'Alert'
  });
  alert.present();
}

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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/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: https://material.google.com/components/bottom-navigation.html

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/app.md.scss:

$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: http://ionicframework.com/docs/v2/theming/overriding-ionic-variables/

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

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

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

becomes:

constructor(private popoverCtrl: PopoverController) {}

presentPopover(event) {
  let popover = this.popoverCtrl.create(PopoverPage);
  popover.present({ ev: event });
}

Update any uses of ViewController.onDismiss to ViewController.onDidDismiss. The following code on dismiss of a modal:

modal.onDismiss(() => {

});

becomes:

modal.onDidDismiss(() => {

});

Update any uses of checked on an <ion-option> to use selected.
If you are using any of the tab config variables, update them to reflect the new names above.
If you are using any of the Sass Variables to override tabs or input highlights, update them to reflect the new names above.
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)

Features

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)

BREAKING CHANGES

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

<ion-header>
  <ion-navbar></ion-navbar>
</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

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

Remove the *navbar attribute so this:

<ion-navbar *navbar>

becomes this:

<ion-navbar>

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

<ion-navbar>
  <ion-title>
    Navbar Title
  </ion-title>
</ion-navbar>

<ion-toolbar>
  <ion-title>
    Toolbar Title
  </ion-title>
</ion-toolbar>

<ion-content>

</ion-content>

becomes:

<ion-header>
  <ion-navbar>
    <ion-title>
      Navbar Title
    </ion-title>
  </ion-navbar>

  <ion-toolbar>
    <ion-title>
      Toolbar Title
    </ion-title>
  </ion-toolbar>
</ion-header>

<ion-content>

</ion-content>

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

<ion-content>

</ion-content>

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

becomes:

<ion-content>

</ion-content>

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

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)

Features

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)

BREAKING CHANGES

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 = ev.target.value;
}
```
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.

Features

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](https://github.com/(/issues/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)

BREAKING CHANGES

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

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.

Replace all instances of @Page with @Component:

import {Page} from 'ionic-angular';

@Page({

})

becomes

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

@Component({

})

Replace @App with @Component and then bootstrap it. Move any config properties into the bootstrap:

import {App, Platform} from 'ionic-angular';

@App({
  templateUrl: 'build/app.html',
  providers: [ConferenceData, UserData],
  config: {
    tabbarPlacement: 'bottom'
}
export class MyApp {

}

becomes

import {Component} from '@angular/core';
import {ionicBootstrap, Platform} from 'ionic-angular';

@Component({
  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:
// http://ionicframework.com/docs/v2/api/config/Config/

ionicBootstrap(MyApp, [ConferenceData, UserData], {
  tabbarPlacement: 'bottom'
});

Rename any uses of IonicApp to App:

import {IonicApp} from 'ionic-angular';

constructor(
  private app: IonicApp
) {

becomes

import {App} from 'ionic-angular';

constructor(
  private app: App
) {

Rename any uses of the lifecycle events, for example:

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

becomes

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

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

Rename any Ionic events, for example:

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

becomes

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

Features

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)

Features

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)

BREAKING CHANGES

Angular Update to 2.0.0-rc.1

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

Edit your package.json and remove the angular2 entry:

"angular2": "2.0.0-beta.15"

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

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

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

becomes

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

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>

Replace all template variables in ngFor with let. For example:

*ngFor="#session of group.sessions"

becomes

*ngFor="let session of group.sessions"

Replace all template variables in virtualScroll. For example:

*virtualItem="#item"

becomes

*virtualItem="let item"

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

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

  setPage() {
    let nav = this.app.getComponent('nav');
    nav.push(MyPage);
  }
}

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

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

  constructor() {}

  setPage() {
    this.nav.push(MyPage);
  }
}

and the same example (in JavaScript):

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

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

  setPage() {
    this.nav.push(MyPage);
  }
}

Please see the Ionic Conference App for more usage examples.

Router

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:

$toolbar-ios-title-font-weight
$toolbar-ios-title-text-align
$toolbar-ios-title-text-color

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.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

3.2.1 (2017-05-12)

Bug Fixes

3.2.0 (2017-05-10)

Steps to Upgrade

Bug Fixes

Features

Performance Improvements

3.1.1 (2017-04-28)

Bug Fixes

3.1.0 (2017-04-26)

Steps to Upgrade

Bug Fixes

Features

Performance Improvements

3.0.1 (2017-04-06)

Bug Fixes

3.0.0 (2017-04-05)

Steps to Upgrade to 3.0

Bug Fixes

Code Refactoring

Features

BREAKING CHANGES

Grid

Typography

Slides

2.3.0 (2017-03-22)

Bug Fixes

Features

Performance Improvements

2.2.0 (2017-03-08)

Updating to 2.2.0

What's new

Split Pane

Angular 2.4.8

Ionic Storage

Bug Fixes

Features

2.1.0 (2017-02-23)

Bug Fixes

Features

2.0.1 (2017-02-08)

Bug Fixes

2.0.0 (2017-01-25)

2.0.0-rc.6 (2017-01-24)

Updating to 2.0.0-rc.6

Bug Fixes

Features

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

Updating to 2.0.0-rc.5

What’s changed?

What’s new?

BREAKING CHANGES

Inputs

Slides

Bug Fixes

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

Updating to 2.0.0-rc.4

Bug Fixes

Code Refactoring

Features

Performance Improvements

BREAKING CHANGES

Toolbar

Events

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

Updating to 2.0.0-rc.3

Bug Fixes

Features

Performance Improvements

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

Updating to 2.0.0-rc.2

Bug Fixes

Features

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