Skip to main content

Release Notes

A complete release history for Ionic Framework is available on GitHub. Documentation for recent releases can also be found below.

See versioning for information about our policy and commitment to stability.

5.8.1

patchLatest Production Version

September 22 2021

Bug Fixes

5.8.0 Calcium

minor

September 15 2021

Bug Fixes

Features

  • action-sheet, loading, modal, picker, popover: pass HTML attributes to host element (#23929) (bd96a81)
  • alert, toast: pass arbitrary HTML attributes to host element (#23891) (73a1daf), closes #23825

5.7.0 Potassium

minor

September 1 2021

Bug Fixes

  • alert: AlertButton role now has correct types (#23791) (864212b)
  • label: label now only takes up as much space as needed when slotted (#23807) (9932e26), closes #23806
  • reorder-group: dragging reorder item to bottom no longer gives out of bounds index (#23797) (02409f2), closes #23796
  • vue: router guards are now fire correctly when written in a component (#23821) (3c44222), closes #23820

Features

  • slides: add IonicSlides module for Swiper migration, deprecate ion-slides (#23844) (11fda41), closes #23447

Code Refactoring

  • virtual-scroll: deprecated virtual scroll in favor of solutions provided by JS frameworks (#23854) (a0229bc)

5.6.14

patch

August 18 2021

Bug Fixes

5.6.13

patch

August 4 2021

Bug Fixes

  • checkbox, radio: change event interfaces correctly use TypeScript generics for value (#23044) (8a941fd)
  • gesture: onEnd now correctly fires even if the event target was removed from the DOM (#23713) (4edb5e2), closes #22819
  • item-sliding: opening item while other items are open no longer requires multiple swipes (#23683) (792864f), closes #21579
  • react: IonTabs no longer causes SSR to fail (#23696) (f2a05be), closes #23651
  • vue: improve accuracy of ion-page dev warning (#23677) (fb260a9), closes #23675
  • vue: tabs warning about user-provided router outlet change is now correctly logged (#23724) (4a64e97), closes #23719

5.6.12

patch

July 21 2021

Bug Fixes

  • action-sheet: header, subheader, and icon alignment better matches native ios (#23322) (39315bc), closes #23317
  • button: buttons are now disabled during page transitions (#23589) (3b803eb), closes #23588
  • item: mirror disabled prop to aria attribute (#23544) (9021e7c), closes #23513
  • menu-button: custom aria-label can now be set (#23608) (c08345d), closes #23604
  • overlays: overlay interfaces are now exported from framework packages and documented (#23619) (773bbcb), closes #22790
  • router-outlet: improve reliability of swipe back gesture when quickly swiping back (#23527) (fa06942), closes #22895

5.6.11

patch

July 1 2021

Bug Fixes

  • animation: typescript interface has correct return value for progress methods (#23536) (f3d6abb)
  • ios, md: double tapping back button no longer causes app to go back 2 pages (#23526) (69be51d), closes #18455

5.6.10

patch

June 22 2021

Bug Fixes

  • button: buttons using fill and color properties now account for hover and focused opacity variables (#23442) (68c0e71), closes #23441
  • item: using multiple items with inputs no longer results in console warnings (#23429) (e27b5b6), closes #23427
  • vue: IonTabs can now accept IonRouterOutlet, deprecated default router outlet in tabs (#23477) (a2a4cff), closes #23321

5.6.9

patch

June 8 2021

Bug Fixes

  • modal: swipe to close modal is no longer swipeable on footer (#23401) (ae96563), closes #23398
  • title: inherit padding for iOS title in a toolbar (#23343) (82cfa55), closes #23072
  • vue: improve v-model integration for Vue 3.1.0+ (#23420) (f008628)
  • vue: prevent error from being thrown when testing on certain jest runners (#23421) (60bedb5), closes #23397

5.6.8

patch

May 27 2021

Bug Fixes

5.6.7

patch

May 13 2021

Bug Fixes

  • angular: warnings are no longer generated when running tests with ng test (#23292) (9cb6c80), closes #19926
  • overlays: screen readers no longer read content behind overlays (#23284) (a9b12a5), closes #22714
  • refresher: refresher now only activates when pulling down on MD (#23283) (1e1596f), closes #23245
  • vue: use correct history mode when doing ssr to avoid errors (#23255) (2e00dab), closes #23254

5.6.6

patch

April 29 2021

Bug Fixes

  • angular: back button goes back to proper tab on angular 11.2.10 (#23238) (e436439), closes #23230
  • react: remove hardware back button event listener when NavManager is unmounted (#23224) (c501da7), closes #23170
  • slides: undefined error is no longer thrown after destroying and quickly re-creating ion-slides (#23239) (2ccaabb), closes #22289
  • vue: components inside of ion-nav are now unmounted properly (#23240) (f2f41e2), closes #23233
  • vue: overlay events can now be listened for without the "on" prefix, deprecated "on" prefix event listeners (#23227) (dab927d)

5.6.5

patch

April 22 2021

Bug Fixes

  • content: only render a main element when content is being used in primary view (#23160) (2d07d82)
  • datetime, input, textarea: only add aria-labelledby if there is an adjacent label (#23211) (a31fb55)
  • radio-group: pressing spacebar correctly unselects radio with allow-empty-selection (#23194) (7139b3f), closes #22734
  • react: callback refs now work correctly with ionic components (#23152) (0dd189e), closes #23153
  • segment, segment-button: use tablist and tab roles (#23145) (91ac340)
  • vue: dynamic tabs are now correctly recognized (#23212) (004885b), closes #22847
  • vue: update props when navigating to new parameterized route (#23189) (35c8802)

5.6.4

patch

April 8 2021

Bug Fixes

5.6.3

patch

March 23 2021

Bug Fixes

5.6.2

patch

March 22 2021

Bug Fixes

5.6.1

patch

March 17 2021

Bug Fixes

  • custom-elements: overlays now present correctly when using custom elements build (#23039) (e4bf052), closes #23029
  • item: detail icon is no longer announced by screen readers (#23055) (c877061), closes #23054
  • label: properly float labels for non-input items (#23060) (c8a3999)
  • react: only pass tab event props from IonTabs to IonTabBar if defined (#23024) (f94e618), closes #23023
  • refresher: progressEnd no longer errors when pulling quickly in MD native refresher (#23056) (67617fb)
  • virtual-scroll: allow null in items property (#23047) (2a253a1)
  • vue: passing params as props are correctly updated when switching pages (#23049) (2f54bc1), closes #23043

5.6.0 Argon

minor

March 4 2021

Bug Fixes

  • all: improve support for ids with special characters when getting label element (#22680) (19d63f6), closes #22678
  • header: collapsed toolbar is no longer incorrectly shown when using ion-refresher (#22937) (5300dcc), closes #22829
  • label: only show placeholder with floating label when focused (#22958) (9282aa6), closes #17571
  • progress-bar: use correct theme colors in dark mode (#22965) (b6b2714), closes #20098
  • radio-group: pressing space no longer jumps screen to bottom of page (#22892) (3a0465e), closes #22716
  • react: IonRouterOutlet now respects animated={false} prop (#22905) (da1b7a0), closes #22903
  • react: onIonTabsWillChange and onIonTabsDidChange event handlers are now properly bound to IonTabs (#22233) (b064fde)
  • react, vue: navigating using ion-back-button now selects correct page (#22974) (cd8ffd8), closes #22830
  • react, vue: tab buttons no longer throw an error if href is undefined (#22998) (943e3f6), closes #22997
  • refresher: add correct dark mode styles (#22639) (c05476b), closes #22637
  • vue: correctly remove active state from tab button when navigating away from tab (#23000) (a2763af), closes #22597
  • vue: prevent race conditions when opening overlays (#22883) (68a9b80), closes #22880

Features

5.5.5

patch

February 26 2021

Bug Fixes

5.5.4

patch

February 4 2021

Bug Fixes

5.5.3

patch

January 28 2021

Bug Fixes

  • react: do not unmount overlay inner component until overlay is dismissed (#22813) (ab1fc8f), closes #22761
  • react: adding dynamic class to ion-page no longer hides component (#22666) (a01bdb8), closes #22631
  • react: improve view matching logic (#22569) (f891f66)
  • react, vue: do not show back button when replacing to root page (#22750) (9e9a372), closes #22528
  • refresher: correctly detect spinner when using native refresher (#22800) (e2d8e5c), closes #22706
  • title: only add large title transition when using collapsible header (#22762) (348c50b), closes #22760
  • vue: all ionic vue components can now use router link (#22743) (3d6ac13)
  • vue: correctly determine leaving view when transitioning to a new instance of a previous page (#22655) (e3a05bf), closes #22654 #22658
  • vue: ensure v-model value is properly synced before ionChange event (#22749) (e1d6627), closes #22610
  • vue: improve path matching with tabs, deprecated adding additional pages as children of tabs without a router outlet (#22807) (2a3ce9a), closes #22519
  • vue: improve v-model binding sync between vue wrappers and web components (#22745) (64719f4), closes #22731
  • vue: output commonjs format for node environments (#22766) (7ecae2e)
  • vue: tab bar is now correctly hidden when keyboard is open (#22687) (5c27dd8)

5.5.2

patch

December 9 2020

Bug Fixes

  • android: setting hardwareBackButton: false in config now disables default webview behavior (#22555) (dc9faa6), closes #18237
  • button: allow aria-label to be inherited on inner button (#22632) (818e387), closes #22629
  • react: hardware back button now navigates correctly (36939e1)
  • react: setting a ref now allows other props to be passed in (31f45cd), closes #22609
  • refresher: clean up old css if calling refresh method before native refresher is setup (#22640) (8d5ed47), closes #22636
  • refresher: refresher correctly detects native refresher when shown asynchronously (#22623) (5ed73cd), closes #22616
  • vue: adding non tab button elements inside ion-tab-bar no longer causes errors (#22643) (61cf0c5), closes #22642
  • vue: correctly handle navigation failures (#22621) (216f51b), closes #22591
  • vue: correctly remove old view when replacing route (#22566) (4f4f31b), closes #22492
  • vue: pass in correct route to props function (#22605) (01afdc4), closes #22602
  • vue: query strings are now correctly handled when navigating back (#22615) (a94e2a8), closes #22517
  • vue: swipe back gesture is properly disabled when swipeBackEnabled config is false (#22568) (9d04c12), closes #22567

For Ionic Vue Developers

Vue Router 4 has been released! Be sure to update from the release candidate to the latest stable version of Vue Router.

For more information on the changes in Vue Router 4, see https://github.com/vuejs/vue-router-next/releases/tag/v4.0.0.

npm install vue-router@4

5.5.1

patch

November 25 2020

Bug Fixes

  • checkbox: click handler now fires properly (#22573) (0786835), closes #22557
  • radio: properly announce radios on screen readers and resolve axe errors (#22507) (afcc46e)
  • react: eliminate use of deprecated findDOMNode, resolves #20972 (5275332)
  • router: navigation guards now fire when navigating to a page with params (#22521) (1956f98), closes #22516
  • select: fix a11y issues with axe and screen readers (#22494) (04b874e), closes #21552 #21548
  • select: improvements for announcing placeholder and value on screenreaders (#22556) (ea52db6)
  • vue: onBeforeRouteLeave and onBeforeRouteUpdate hooks now fire properly (#22542) (8002114), closes #22540
  • vue: tabs now correctly fire lifecycle events (#22479) (cdc2fb6), closes #22466
  • vue: unit testing a routerLink-capable component no longer warns of missing router dependency (#22532) (4e23aad), closes #22506

For Ionic Vue Developers

When updating to Ionic Vue v5.5.1 make sure you are on the latest version of vue-router@next to take advantage of the bug fixes in this release:

npm install vue-router@next
To see more releases, visit GitHub.