Enjoy! 🎉

Bug Fixes

• angular: always dispatch lifecycle events (5677daa)

Bug Fixes

• angular: hide pages properly (a44b844)
• angular: make pages invisible before they are rendered (a589816)
• transition: make sure hidden is removed (f52dece)

Bug Fixes

• css: revert hidden css (7d3d98d)
• tab: prevent infinite loop (05b258c)
• toolbar: remove transparent border on translucent toolbar (55cb354)

Bug Fixes

• all: accesibility and global styles for hidden nodes (4b844ef)
• checkbox: get css variable customization working better (3e7aa4b)
• content: set height to make it accessible for children elements (#14772) (857b42d)
• grid: set the flex and width to auto when size is auto (ba30671), closes #14807
• inputs: inputs work inside (8324bd1)
• label: style color (5c0e9e6)
• list: hide the last item border when there are no lines (#14770) (26f7379), closes #14769
• margin: adds css variables (f6c8f3f), closes #14798 #14826
• menu-button: fix sass linting (d22f04b)
• menu-button: get proper styles when used inside ion-buttons (811eee7)
• modal: use flex to position modal to make it easier to size (9488a98), closes #14392
• overlay: remove global css vars in overlays for local ones (38b1e47)
• refresher: find parent ion-content properly (4eab209), closes #14833
• slides: swiper container should take up 100% height (1d201ec), closes #14771
• spinner: color can be customized in non-shadow-dom (65008e7)
• spinner: get paused attribute working and update tests (3ab1e2d), closes #14811

Features

• button: overflow is configurable (ddb1e49), closes #14839
• menu: add getWidth() (cb4acab), closes #14794

Bug Fixes

• anchor: add proper styling, support for colors, and basic test (1dbf5bb), closes #14777
• anchor: inner inherits text styles (9aedfc6)
• button: add box-sizing so anchor buttons won't exceed max-width (9c9f081), closes #14760
• button: set display type on host (89d1526)
• button: submit form w/ ion-button within shadow dom (4ed8541), closes #14776
• item: add cursor pointer back to native item (43f1fec), closes #14743
• searchbar: use tag in toolbar context selector (124b87c)
• segment: add styles for in a color toolbar (d9e4ca7)
• spinner: style CSS props (2798bb0)
• tab: props are reactive (00c4c77)
• tab-button: add a class to hide the tab when show is false (eb9ed17)
• tabs: add the colors to the tabbar as well (5348e7c), closes #14758
• tabs: fix the tabs so the color property works on tab button (8aed3bf), closes #14758
• virtual-scroll: read viewport size for every scroll event (1d3eb3f)

Bug Fixes

• angular: avoid TS 2.8 features (c736bac)
• angular: correct subscription to cordova ready event (#14577) (5967352)
• bundling: fix EventEmitter import (8e47101)
• linting (e629e29)
• icon: target element for style and add to breaking (949d93e)
• overlay: make type an any (15dc651)
• router: fix reuse strategy (bd53bba)
• scripts: update github release notes (fc078af)
• tabs: align tab title and icons to flex-start (c11d74b), closes #14606

Features

• all: custom icons (e6638e7)
• dir: default to ltr css, rtl overrides w/ [dir=rtl] selectors (fb4353c)
• slides: update swiper to latest (8e164d6)

Bug Fixes

• all: strong typing for color (618f708)
• angula: platform logic belongs to core (af5db2f)
• angular: build script (a88e1e8)
• angular: params are assigned to props (7fa6e43)
• angular: populated the platforms array (#14466) (d177087)
• angular: Required<> is not available (8aa6965)
• angular: routerLink integration (ed8ff4f)
• content: scrol-inner takes all height (3da0c98)
• nav: Remove console.log (#14467) (d93b1d5)
• refresher: adds threshold (34ae904)
• router: accepts root direction (ae9d0c7)
• router: fix push() public interface (875b9d0)

Features

• img: adds lazy load image (b06c65f)

Bug Fixes

• angular: compare router params length (b3a9c7f)
• angular: Config provider (329a348)
• angular: platform.ready() returns type (c0ec02e)
• angular: update proxies (da0bfc7)
• config: add object.entries polyfil (c917a3c)
• config: add setupConfig util (0c1476e)
• lint: import order (8b1452c)
• nav: rename animate to animated (98a3519)
• prerender: router compatible with prerender (9c7b0ca)
• router: error when it can't initialize property (e56b2ee)
• router: initial load waits until outlet attaches (c905ba4)
• router: root prop (89d5a35)
• router: writeURL() for non root base (af4bcb8)
• scripts: github release (545d3c2)
• segment: checked can be changed dynamically (78454b4)
• select: cssClass + strong typed (826e02b)
• toast: only use constant and env if supported (#14399) (9bee0f0)
• validate: fix type errors (3328314)

Features

• router: add willChange event (d613411)

3.9.2 (2017-11-08)

Upgrade Instructions

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

npm install [email protected] --save

Bug Fixes

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

3.9.1 (2017-11-08)

Upgrade Instructions

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

npm install [email protected] --save

Bug Fixes

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

3.9.0 (2017-11-08)

Upgrade Instructions

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

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

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

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

RXJS 5.5.2 Updates

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

Traditionally, operators were applied like this:

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

export MyClass {


  someMethod(){
    // Using Reactive Forms
    this.input.valueChanges
    .debounceTime(500)
    .switchMap(inputVal => this.service.get(inputVal))
    .subscribe(res => console.log(res))
  }
}

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

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

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

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

export MyClass {


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

    this.input.valueChanges
    .pipe(
      debounceTime(500),
      switchMap(inputVal => this.service.get(inputVal))
    )
    .subscribe(res => console.log(res))
  }
}

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

Take a look at this
doc for more information.

Bug Fixes

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

3.8.0 (2017-10-26)

Upgrade Instructions

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

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

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

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

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

Bug Fixes

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

Features

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

3.7.1 (2017-09-29)

Upgrade Instructions

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

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

Bug Fixes

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

Features

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

3.7.0 (2017-09-28)

Bug Fixes

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

Features

• initial iphoneX support (112d4f5)

Reverts

• item: revert the change from margin to padding right (921ccbb)

3.6.1 (2017-09-07)

Upgrade Instructions

[email protected] is a drop-in replacement for 3.6.0. To install it, please run:

npm install -g ionic@latest
npm install @ionic/[email protected] --save-dev
npm install [email protected] --save

Bug Fixes

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

Upgrade Instructions

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

To upgrade, please run

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

Notes

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

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

New Generators

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

ionic g page <Page-Name>

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

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

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

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

So running:

ionic g component music-card

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

Bug Fixes

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

Features

• generators: refactor generators (400aa54)

3.5.3 (2017-07-14)

Bug Fixes

• app: restore getActiveNav api (2d49e10)

Upgrade Instructions

[email protected] is a drop-in replacement for 3.5.1. To install it, simply run npm install [email protected] --save --save-exact.

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

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

rm -rf node_modules
npm install @ionic/[email protected] --save --save-exact

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

...
<body>

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

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

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

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

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

</body>
...

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

Notes

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

Bug Fixes

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

Features

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