ionic-framework

Bug Fixes

• react: add missing react memory router (8a5aba2)
• react: fixing type of icon in ToastOptions, ActionSheetOptions, fixes #20100 (857bab6)
• react: supporting ios and md props on icons (#20170) (676cc19)

Features

• refresher: add MD native refresher (#20096) (5b81bdf), closes #17316

Bug Fixes

• animation: support css animation on older devices (#20020) (49c394c), closes #20017
• icons: fix the ellipsis fill in ionicons (#20137) (9318d24)
• modal: account for safe area on devices with a notch (#20072) (1cabb53)
• react: fire lifecycle events on initial render, fixes #20071 (2dcf3ee)

Code Refactoring

• searchbar: set inputmode default to undefined (#20080) (6612604), closes #20074

Features

• angular: angular 9 support (#19515) (2344d0b)
• checkbox: add --checkmark-width variable (#19933) (c32a7bc), closes #16803
• radio: add --border-radius and --inner-border-radius variables (#20140) (a01c102)
• refresher: add iOS native refresher (#20037) (04e7c03), closes #18664
• toggle: add --border-radius and --handle-border-radius variables (#20141) (02a46a1)

BREAKING CHANGES

We recommend updating to the latest version of 4.x before trying out version 5 in order to see deprecation warnings related to your app in the developer console.

• searchbar: The inputmode property for ion-searchbar now defaults to undefined. To get the old behavior, set the inputmode property to "search".

Bug Fixes

• react: fire lifecycle events on initial render, fixes #20071 (9ea75eb)

Bug Fixes

• animation: convert hyphenated properties to camel case when using Web Animations (#20059) (56f67bd), closes #20058
• animation: properly update Web Animation object (#19964) (e766194)
• picker: pass selected value to handler on dismiss (#20042) (6e0b9c4), closes #20036
• tabs: preserve route navigation extras when changing tabs (#18493) (4c8f32f), closes #18717
• title: add correct safe area to large title nav transition (#20029) (300d543), closes #20028

Features

• modal: add card-style presentation with swipe to close gesture (#19428) (b3b3312), closes #18660

Bug Fixes

• react: don't show back button when not appropriate (684293d)
• react: first render performance improvements (1c7d1e5)
• react: fix refs for controllers, overlays, ionpage, and ionrouteroutlet, fixes #19924 (#20012) (eef55bb)
• react: support for 'root' router direction, fixes #19982 (#20052) (e116712)
• react: support navigating to same page and route updates in IonRouterOutlet, fixes #19891, #19892, #19986 (f9bf8db)

Upgrade Note

If you run into a "Property 'translate' is missing in type" error building after updating to 4.11.6, update your React Typings library to the latest:

npm i @types/react@latest @types/react-dom@latest

Bug Fixes

• animation: track correctly when updating CSS Animation (#19813) (7bd4412)
• card: update background to use the same as item (#19602) (1a8b7a4)
• content: set fixed content to position absolute (#19867) (fce3e24), closes #17754
• gesture: release gesture when disabling (#19855) (21484f1), closes #19848
• header: avoid flicker on collapsible header load (#19682) (0a7aae2)
• header: avoid flicker when collapsing (#19850) (a3666dd), closes #19839
• header: support collapsible header with multiple toolbars (#19909) (fc4bb2d)
• header: translucent toolbars now work with collapsible header (#19774) (b642b53), closes #19773
• title: only animate large title if back button is in start slot (#19846) (cace1b3), closes #19840
• nav-params: set generic type on navigation parameters get() (#19195) (504051d)
• picker: pass data and role to dismiss (#19787) (7988720), closes #18454
• searchbar: use back button config value for cancel icon (#19353) (3d6f3b9)
• textarea: remove padding from textarea placeholder (#19694) (f63d37a), closes #19616
• toast: call button handler on cancel (#19793) (420aa66), closes #19791

Features

• animation: animation identifiers (#19771) (7d41715), closes #19550
• animation: cubic-bezier easing conversion utility (experimental) (#19788) (96a5e60), closes #19789
• alert: add support for textarea inputs (#16851) (b28cf02), closes #14153
• angular: expose Ionic Animations via AnimationController (#19745) (67a7e23)
• angular: expose Ionic Gestures via GestureController (#19864) (48a7662)
• searchbar: add --box-shadow variable to style searchbar input (#19838) (1ab7066)
• select: add --placeholder-opacity and --placeholder-color, expose shadow parts (#19893) (bef0f53), closes #17446
• split-pane: convert to shadow component, add width, max-width, and min-width vars (#19754) (d80f455), closes #17088

Breaking Changes

We recommend updating to the latest version of 4.x before trying out version 5 in order to see deprecation warnings related to your app in the developer console.

• back-button: convert back button to shadow (#19411) (0d40d3f)
• ionicons: update to Ionicons v5. See https://ionicons.com for more information. (#19670) (69e10de)
• list-header: redesign list header to match latest iOS spec (#19915) (5bbb95f)
• split-pane: convert split-pane to shadow (#19754) (d80f455)

Bug Fixes

• react: improved lifecycle hooks to deal with stale closures, fixes #19873 (#19874) (5ff786a)

Bug Fixes

• react: check for component unmount, fixes #19859 (7356c40)
• react: adding multiple subscriptions to lifecycle events, fixes #19792 (#19858) (0a3014d)
• react: add check to warn if no ionpage is found, fixes #19832 (#19857) (628e766)
• react: expand the location stack to better support back button, fixes #19748 (#19856) (d89508b)
• react: adding hardware back button support, fixes(#19819) (#19851) (fd9745d)
• react: adding swipe back functionality and routerOutlet ready improvements, fixes #19818 (#19849) (bcc40c8)
• react: create a new overlay each time component is presented, fixes #19841, #19823 (#19842) (9fad416)

Bug Fixes

• react: adding change events to iontabs, fixes #19665 (#19711) (b7baf24)
• react: adding HashRouter to available ion routers, fixes #19621 (#19683) (fcdbb3c)
• react: checking if node is actually an element before treating it like one, fixes #19769 (#19783) (9d0caf6)
• react: checking isOpen again after async call before opening overlay, fixes #19755 (f70e71a)
• react: don't remove current view, provide a better method to determine showGoBack fixes #19731 and #19732 (31c754d)
• react: removing pages from DOM on nav, fixes #19701 (#19712) (ee21d3a)
• react: unmount leaving view when using browser back button, fixes #19749 (#19781) (2dc5540)

Bug Fixes

• animations: ensure all elements are cleaned up when calling .destroy() (#19654) (d97e167)
• header: collapsible header works in tabs (#19658) (4853909), closes #19640
• ios: hide leaving view after nav transition to avoid flicker (#19691) (70e0562), closes #19674
• menu: clamp out of bounds swipe value (#19684) (1535e95), closes #18927
• react: add IonPicker as controller component, fixes #19620 (#19643) (ed98d9e)
• react: adding change events to IonTabs, fixes #19665 (#19711) (b7baf24)
• react: adding HashRouter to available ion routers, fixes #19621 (#19683) (fcdbb3c)
• react: pages no longer hidden when navigating between tabs, fixes #19646 (#19647) (8776556)
• react: ensure views are removed from DOM after navigating back, fixes #19701 (#19712) (ee21d3a)

Bug Fixes

• animations: ensure all elements are cleaned up when calling .destroy() (#19654) (2f88237)
• css: update responsive display media queries (#18601) (5d6e077), closes #18600
• grid: remove padding on children columns when grid has ion-no-padding (#19592) (17119f5), closes #17459
• toast: inherit height in container to center align content (#19409) (250718a)

Features

• components: cascade mode from parent to child components (#19369) (3dd5f05), closes #18285
• menu: default to overlay for ios menu (#19063) (dbf6a44), closes #18662
• overlays: add global backdrop opacity variable for animations (#19533) (bd22926), closes #16446

Performance Improvements

• animations: do not create setTimeout if infinite iterations (#19632) (0d699fb), closes #19627
• animations: wrap loops in requestAnimationFrame call (#19630) (589e67e), closes #19629

Breaking Changes

We recommend updating to the latest version of 4.x before trying out version 5 in order to see deprecation warnings related to your app in the developer console.

• all: mode is now cascaded from parent to child component. If this is not desired set a different mode on the child component. (#19369) (55462d7)

• anchor: remove ion-anchor, use ion-router-link instead. (#18935) (e7cd197)

• card: convert card to shadow. (#19395) (08bb60d)

• css: responsive display media queries in the display CSS file have been updated. Instead of using the maximum value of that breakpoint (for .ion-hide-{breakpoint}-down classes) the maximum of the media query will be the minimum of that breakpoint. (#18601) (40a8bff)

• css: remove all CSS utility attributes. Use CSS classes instead. See the documentation for the correct class names: https://ionicframework.com/docs/layout/css-utilities (#18956) (04862df)

  BEFORE:

  <ion-header text-center></ion-header>
  <ion-content padding></ion-content>
  <ion-label text-wrap></ion-label>
  <ion-item wrap></ion-item>
  

  AFTER:

  <ion-header class="ion-text-center"></ion-header>
  <ion-content class="ion-padding"></ion-content>
  <ion-label class="ion-text-wrap"></ion-label>
  <ion-item class="ion-wrap"></ion-item>
  

• events: remove the Events service. (#19600) (8d4a721)

  • Use "Observables" for a similar pub/sub architecture: https://angular.io/guide/observables
  • Use "Redux" for advanced state management: https://ngrx.io

• header/footer: remove no-border attribute from header/footer, use ion-no-border class instead. (#18954) (d9f6119)

• menu: iOS menu now defaults to overlay, set type to "reveal" to get the old behavior. (#19063) (ccb54a1)

• menu-controller: remove swipeEnable(), use swipeGesture() instead. (#19526) (30bd8fd)

• nav: remove ion-nav-pop, ion-nav-push and ion-nav-set-root. Use ion-nav-link with routerDirection instead. (#19240) (e334d73)

• searchbar: remove boolean values from showCancelButton, use string values: "always", "focus", "never". (#18953) (508e186)

  BEFORE:

  <ion-searchbar show-cancel-button>
  <ion-searchbar show-cancel-button="true">
  <ion-searchbar show-cancel-button="false">
  

  AFTER:

  <ion-searchbar show-cancel-button="focus">
  <ion-searchbar show-cancel-button="focus">
  <ion-searchbar show-cancel-button="never">
  

• scss: remove scss files from dist/, use CSS variables to theme instead. (#19292) (6450aff)

• skeleton-text: remove width property. Use CSS instead. (#18936) (7c3db79)

• split-pane: remove main attribute. Use contentId instead. (#19511) (02d7841)

  BEFORE:

  <ion-split-pane>
    ...
    <div main>...</div>
  </ion-split-pane>
  

  AFTER:

  <ion-split-pane content-id="main-content">
    ...
    <div id="main-content">...</div>
  </ion-split-pane>
  

• theming: ionic default colors have been updated. (#19279) (7f4cf08)

• toast: remove showCloseButton and closeButtonText, add a button using the buttons property with role: 'cancel' instead. (#18957) (ad7f112)

Bug Fixes

• build: properly update peer dependencies (#19639) (b552daa)
• react: add IonPicker as controller component, fixes #19620 (#19643) (ed98d9e)
• react: handle tab back nav better, fixes #19646 (#19647) (8776556)
• react: moving tslint and friends to devDependencies (#19624) (7f4b77d)

Ionic React! Enjoy! 🧂 🌊 🐼

Bug Fixes

• content: set overscroll only on iOS (#19470) (63c2008), closes #19465
• searchbar: update alignment of chips and other elements in toolbar (#19596) (637f26b), closes #19495 #19502

Bug Fixes

• overlay: ensure lifecycle events fire properly (#19579) (a7b9642), closes #19576

Bug Fixes

• animation: animation timer fallback now accounts for iterations (#19527) (9f5ed23)
• css: update deprecations to remove wrap (#19535) (bfb704e), closes #19499
• header: fix collapsing iOS header when using with split pane (#19480) (dea1c26), closes #19541
• list: add bottom border for first item in inset list (#19525) (71b8853), closes #19507
• md: fix flicker when navigating back in MD mode on certain Android devices (#19553) (19ee21a), closes #19491
• searchbar: update padding and button alignment (#19532) (77658e6), closes #19502

Bug Fixes

• angular: add warning if initialized more than once (#19393) (e98769e)
• animation: set property defaults to avoid inconsistencies (#19321) (1cbb52c)
• animation: fallback to CSS Animations on older versions of Chrome (#19288) (2d39c07), closes #19272
• animation: animations of duration 0 now run in Safari (#19287) (4e544f1), closes #19285
• components: fix crash in IE11 when using classList add() or remove() (#19460) (b4d92c6)
• components: improve CSS Variable support in IE11 (#19473) (44ad074)
• content: remove pointer-events from iOS transition shadow (#19471) (8a52c7d), closes #19466
• menu: menus show proper drop shadows (#19454) (eab0865), closes #19387
• radio-group: get radios before caching value to avoid infinite loop (#19448) (cf223e4), closes #19277
• react: update events to use proper types (c79e74b)
• router-outlet: hide leaving view after transition finishes (#19335) (bfa17d1)

Features

• config: expose getMode() and deprecate Config.set() (#19104) (0f05ea4)
• docs: add VSCode docs support (#19309) (a3f345c)
• title: add support for small title (#19215) (e27962d), closes #18898
• title: add support for large title (experimental) (#19268) (923312e), closes #16885

Performance Improvements

• animation: avoid ngzone with requestAnimationFrame (#19457) (8ca97ce)

Bug Fixes

• platform: properly detect iPads running iPadOS (#19258) (4a90096)

Bug Fixes

• animation: add correct onFinish interface parameters (#19199) (a81653b)
• animation: improve Web Animation feature detection accuracy (#19212) (6eca5b0), closes #19205
• animation: properly clean up elements when using destroy (#19210) (93f2064)
• segment: do not emit ionChange until didLoad (#19218) (9751f14), closes #19204

Features

• nav-link: add nav-link and deprecate nav-push, nav-pop, and nav-set-root (#18909) (c3044f5)
• slides: expose full Swiper API (#19137) (e1fa461)