ionic-framework

Bug Fixes

• animation: always call onFinish() (c23c5a4)
• button: vanilla color is usable (b8b9b83)
• segment: unselected color (b9e42eb)
• slides: swiper is not required as dependency (29f324b)

Bug Fixes

• anchor: make it activatable (6c62e6c)
• angular: only append the component when the parent element is not the container element (6d6f70c), closes #14737
• back-button: subscribe to body (37c9be7)
• button: add custom properties and remove --ion-color overrides (#15463) (3af4361), closes #14808 #14853 #14850
• core: matchBreakpoint will return true if breakPoint is empty string (#15498) (b362b0a), closes #15495
• esm: reorganiza exports (bb19243)
• fab-button: add routerDirection (2398634), closes #15551
• input: value might be null/undefined (83543b7)
• item: update hostContext to use ion-item element (21d1f2e)
• item-option: add activated and ripple to button (78e2a0a), closes #14943
• item-option: enable ripple-effect (428a5da)
• item-sliding: make sure options are ready (7f59f91)
• list-header: add and document custom properties (5ccc1fd), closes #14850 #14853 #14808
• menu: ios styles (281f9a3)
• nav: matches() function (9420b88)
• overlay: animation can be interrupted (ca58664), closes #15506
• overlay: only register backButton listener once (75c2d74)
• popover: content sizing, scoped css (51d4e08), closes #15237 #15589 #15331
• popover: remove unneeded code (b26c017)
• radio: add and document custom properties (0f9a7b4), closes #14850
• range: update range ratio when new min/max are passed (#15512) (f62601f), closes #15511
• searchbar: add and document custom properties (7f57e02), closes #14850
• searchbar: inherit color from color toolbar (3042f57)
• searchbar: ionCancel event (20a7599), closes #15476
• segment: fix css var + host-context() (49ab065)
• slides: correct order of parameters (6442dfc), closes #15407
• slides: Methods wait for execution until swiper is initialized (#15576) (ea01900)
• slides: Update swiperOptions default to match version 4 of Swiper (#15578) (db35af2)
• slides: Updated lockSwipes methods to match the new swiper.js API (#15469) (efb99cb)
• sliding-item: swipe event (127da1a)
• test: treeshake check runs last (b56f136)
• test: workaround for nav tests (a4b1179)
• toast: adds role timeout and cancel (2f2a255), closes #15477
• toast: render on top (ac42180)
• toggle: empty hidden input value when not checked (1f19862)
• handle failure in hardware back button (6da765b)
• remove argument-less catch() (ff919de)

Features

• angular: integrate back-button with ng router (1bcca01)
• app: hardware back button support (dfac9dc)
• overlays: close overlay with back-button (4ccbefa)
• router: add support for relative paths (b28aeab), closes #15499
• virtual-scroller: add support (d40d0a7)

Performance Improvements

• router: prevent initializaing page twice (3dd9604)
• slides: tree-shake dependency (9d3a259)

Bug Fixes

• list: add closeSlidingItems() (81fbbb8), closes #15378
• menu: await animation check (f00db59), closes #15377
• range: add and document custom properties (cf35445), closes #14850 #14808
• slides: isEnd() returns a boolean (771c517), closes #15376

Breaking Changes

• All methods of all ionic components return a promise.
• colors.css has been renamed to core.css, the global stylesheet needs to be updated:

Stencil

+ @import "~@ionic/core/css/core.css";
  @import "~@ionic/core/css/normalize.css";
  @import "~@ionic/core/css/structure.css";
  @import "~@ionic/core/css/typography.css";
- @import "~@ionic/core/css/colors.css";

  @import "~@ionic/core/css/padding.css";
  @import "~@ionic/core/css/float-elements.css";
  @import "~@ionic/core/css/text-alignment.css";
  @import "~@ionic/core/css/flex-utils.css";

Angular

+ @import "~@ionic/angular/css/core.css";
  @import "~@ionic/angular/css/normalize.css";
  @import "~@ionic/angular/css/structure.css";
  @import "~@ionic/angular/css/typography.css";
- @import "~@ionic/angular/css/colors.css";

  @import "~@ionic/angular/css/padding.css";
  @import "~@ionic/angular/css/float-elements.css";
  @import "~@ionic/angular/css/text-alignment.css";
  @import "~@ionic/angular/css/flex-utils.css";

Bug Fixes

• alert: header is not mandatory (1f71f76)
• alert: name is non-null (2268346)
• alert: type and name props are optional (#14815) (99a2925)
• angular: NavController signatures (6fdeb31), closes #15353
• angular: overlay not found (8dfc52f), closes #15349
• angular: platform does not crash (82f9fd4), closes #15348
• angular: virtual-scroll (f9bf5c0), closes #15355
• css: add core.css (#15220) (096d9a7), closes #15170
• datetime: fix year to allow current and max year (f30ae88), closes #14895
• grid: working check for CSS custom variables in Safari (#15228) (baefda3)
• ion-reorder-group: adds ionItemReorder event (7fc170c), closes #14640
• overlay: overlay is not hidden (89ba55d)
• overlay: overlays are hidden until presented (ba428cd), closes #15345
• overlays: expose mode, id, keyboardClose (cc960c3), closes #15366
• radio-group: accept any value (16452b2), closes #15334
• segment: set --color-checked in md color toolbar (5d32115), closes #14850
• toast: add position middle (25479e4)

Bug Fixes

• Ionic/angular compiler error

Breaking Changes

NavController

Changes are required to accommodate some new useful routing APIs and match the ng router ones closely:

goForward() -> navigateForward()
goBack() -> navigateBack()
goRoot() -> navigateRoot()

Dependencies

The following dependencies need to be updated to resolve build errors

• Update Angular to 6.1 or higher
  • Angular changelog
• Update Typescript to 2.9.2
  • "typescript": "~2.9.2"

Bug Fixes

• alert: remove unneeded warning (8447f28)
• all: add customization of font-style (c957ea6)
• angular: back navigation and back-button play better (#15293) (9ddfb1b), closes #15290
• angular: expose router.navigate() (7aa4f13), closes #15332
• app: --ion-safe-area-right typo (77ca2bd)
• app: listen statusTap event (dc82675)
• app: statusbarPadding config is a boolean (b387de4)
• build: do not export in component modules (da2dc7b)
• buttons: margin between buttons (359c47f)
• card: remove calculated width to work with dynamic margin (059d365), closes #15223
• chip: add and document custom properties (07e99a1), closes #14850 #14853 #14808
• config: scrollAssist boolean definition (#15203) (2af72fa)
• config: using sessionStorage is not safe (091b433)
• content: document and add custom properties (0372aec), closes #14850 #14808 #14853
• content: fix scroll events (962578e), closes #15244
• content: scrollToPoint reliability (e0f1259), closes #15257
• datetime: allow values to be zero (#14480) (e0b8e24)
• docs: add missed menu title in the list (#15300) (5f3c7cd)
• docs: use shape property to get round buttons (#15321) (d4c812f)
• docs: use shape property to get round buttons (#15322) (5c6fe45)
• hide-when: mode is a reserved property (c446d1b)
• img: add object-fit to the host to avoid skewing the inner img (2e94227)
• infinite-scroll: remove unused method (926758e)
• input: clearInput works in device (ac96705), closes #15319
• menu: do not override --ion-color-base (a890828)
• modal: make sure content is ready (2c8bc04), closes #14969
• nav: remove nav-decor once transition finished (b8a87fb), closes #15121
• note: do not overide --ion-color-base (5f90dbf)
• overlay: expose "animated" API (8b768fb), closes #14775
• overlays: dismiss last overlay (c1c5102)
• overlays: esc button works closed top overlays (c567a82), closes #14662
• picker: tune scrolling speed (bd75bf4)
• platform: better detect platforms + css API (3ffa3cd), closes #15165 #15116
• popover: make sure content is ready (8bf60e7)
• popover: they should not below other overlays (d83e7f8), closes #14662
• refresher: tune threshold (d129f62), closes #15233
• ripple-effect: add and document custom properties (37a149c), closes #14850
• segment: add and document custom properties (08c6c97), closes #14850 #14808 #14854
• select: add and document custom properties (88613ff), closes #14850
• select: random type in generated.d.ts (11edc49)
• select: support any kind of value (151c58e), closes #15200
• skeleton-text: add and document custom properties (b213500), closes #14850
• slides: document custom properties (ecf1eb8), closes #14850
• split-pane: add and document custom properties (9104850), closes #14850
• textarea: remove autocomplete prop (5989f15)
• title: mode is inherited (94ea0a6), closes #15187
• toggle: cursor: pointer in desktop (86acb8c)
• toolbar: add position relative to host for toolbar background (ac2db9f), closes #15193
• transition: cleanup transition (70a38ac), closes #15317
• virtual-scroll: update VS when items change (3adfb98)

Features

• all: strong typed ComponentProps (57d2375)
• inputs: add focus() method (c66a34a), closes #15266 #15268
• platform: add capacitor (7356ba5)

Performance Improvements

• overlay: prevent layout thrashing (ed5c8eb)
• ripple-effect: using requestIdleCallback (ea1c3d4)

Bug Fixes

• all: improve text customization (6e3e07b)
• all: safe-area using css variables (aa23d08)
• all: user-select for desktop (2d70ee4)
• anchor: add custom properties and make sure color works properly (8fef263), closes #14850
• angular: add ion-backdrop (89e8256), closes #14971
• angular: save internal data (f84bb76), closes #14888 #14885 #15054 #15050
• avatar: document and add custom properties (6738ab7), closes #14850
• badge: add custom properties and make sure color works properly (9beca98), closes #14850
• card: add custom CSS properties and remove css overrides on item (5ed2201), closes #14850 #14808 #9198 #12646
• card-subtitle: add and document custom CSS properties (7050039), closes #14850 #14808
• card-title: add and document custom CSS properties (1ad9818), closes #14850 #14808
• checkbox: document and add custom CSS properties (3e3cc6c), closes #14850 #14808
• config: add persistance mode (db0049f), closes #15102
• config: persistConfig (1e1964d)
• content: overflow-behavior: contain (6173479)
• content: scrolling Y (01323ac)
• content: scrollToTop (695abcf)
• css: --ion-item-background > --ion-item-background-color (#15101) (e3010e1)
• datetime: add open() method (f032769), closes #14923
• docs: replace ion-navbar with ion-toolbar (#15126) (0219309)
• fab-button: sets pointer-events none when disabled (04d33e5), closes #15129 #15120
• input: event interfaces (2e7d355)
• menu: dismiss when clicking outside (288eeb5), closes #15096
• picker: allow 0 as the selectedIndex (d19061c), closes #14563
• range: adds css var (3ab835c), closes #15064
• router: transition race condition (50ad1e7), closes #14873 #15090
• segment: center align text (154b70e)
• segment-button: add and document custom properties (85ffe01), closes #14850
• select: apply proper styles for stacked/floating selects (42ca99d), closes #15140 #14850
• spinner: add and document custom properties (da6df2a), closes #14850
• split-pane: disabled prop is dynamic (149039b), closes #14959
• tabbar: fix highlight bar (39104cb)
• tabs: get the tabbar layout working with shadow DOM (#15113) (575c5eb), closes #14611
• tap-click: nested buttons get activated first (03da98e)
• tap-click: works inside shadow-dom (0dc70f7), closes #15128
• textarea: add and document custom properties (5dfcd47)
• textarea: add ion color classes (5627811)
• thumbnail: add and document custom properties (c88e1ad), closes #14850
• toast: add and document custom properties (5f6f6a1), closes #14850
• toast: statusbarPadding (3da1bf4)
• toggle: add and document custom properties (773c2c2), closes #14850
• toolbar: add and document custom properties (dd114ff)
• virtual-scroll: fix viewportOffset calculation (b7e741a), closes #14963
• virtual-scroll: use FunctionalComponent for JSX integration (b53ce4b)

Features

• config: strongly typed config (0169045), closes #15097
• select: add open method (4047812), closes #14881

Bug Fixes

• all: buttons are type="button" (2b7007f)
• app: fix statusbarPadding (2c925b7), closes #15073
• chip: conforms to ion-icon (f49fa4a), closes #15053
• content: remove scroll-inner (efd77c9), closes #14985
• datetime: fix gesture (e9fd184)
• datetime: ionChange event (8b35e37)
• header: safe margin when statubarPadding=0 (b69d01d)
• input: hide clear button (141b86c), closes #15002
• menu: add width and small-width css variables (#14997) (69f5cc8)
• menu: content's box-shadow (48e2a4e)
• nav: animation backdrop (948d083)
• popover: ion-scroll sizing (b85d4a0), closes #14911
• range: value changes when using keyboard (27fdc9a), closes #15065
• searchbar: color (14d6270), closes #14998
• sliding: fix core gesture logic + priority configuration (a77ee2a), closes #14763
• split-pane: side=end works properly (dc50003), closes #15013
• tab: edge prop (2a4327f), closes #15003
• tap-click: desktop also needs tap-click (9f4d873)

Features

• core: add check for standalone mode (#15001) (0b4b9fe)
• item-sliding: adds disabled prop (9773e2a), closes #14831

Performance Improvements

• app: move app css to global css (a71f382)
• menu: flickering (8253b04)
• scroll: filter velocity using exponential moving window (419ef7b)

Bug Fixes

• accesibility: boolean aria-* properties (4f9cbfe)
• all: strong type text fields (1d001a3)
• all: updated tslint rules to latest (92e21a8)
• angular: events (7a0545d), closes #14866
• angular: ion-router-outlet exposes animated (266336e), closes #14913
• angular: pass proper animated value (7813acc)
• app: statusbarPadding (fd8f875)
• app: user-select on desktop (8a1ad1d)
• button: do not change border radius if round button in toolbar (#14941) (ad006dd), closes #7661
• button: improve text style inherency (25423a0), closes #14927
• button: submit forms using fake button (c05d672), closes #14890 #14786
• color: make desktop selection beautiful (0cdb500)
• config: avoid using startWith for IE support (73a9f14), closes #14922
• content: bottom padding (be4eda5)
• fab: add styles for disabled (520da8d), closes #14867
• flex-utils: add missing flex attributes (7c12e1b)
• input: add color support for ion-input (f676f98), closes #14864
• inputs: better customization for placeholder color (517104f)
• item: only use pointer cursor for and (f19553f)
• pointer-events: listening to document (afb0906)
• refresher: default to disabled false, add to breaking changes (f1826a6), closes #14879
• router-outlet: fix stack attribute detection (#14921) (16e992a)
• searchbar: fix input bluring (d65174b), closes #14916
• slides: update events to match swipers (fc0d4c0), closes #14865
• title: can be used nested (d1969bd), closes #14905
• title: support color (7da0ac4)

Features

• menu: configurable using menuType (a62759c), closes #14901

Performance Improvements

• app: tap-click is a ES (b0ac5ba)
• css: always emit compressed css (143f0f0)
• gesture: lazy loaded dynamic ES module (49cac8b)
• icon: disable icon lazy loading when it's not needed (7292fc7)

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