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.

Ca5.8.4

5.8.4

patchLatest Production Version

October 11 2021

Bug Fixes

angular: setup config properly (#24054) (e001f24), closes #24051 #24052
back-button: pass aria-label to native element (#24027) (68a7e43)

Ca5.8.3

5.8.3

patch

October 7 2021

Bug Fixes

react: overlay hooks dismiss method now works (#24038) (655631d), closes #24030

Ca5.8.2

5.8.2

patch

October 6 2021

Bug Fixes

alert: made it easier to tell if alert is scrollable in MD mode (#23976) (a262753)
angular: use initialize function when setting up ionic angular to avoid config errors (#24004) (f112ad4), closes #22853
item-sliding: closing an item can no longer be interrupted (#23973) (3ca0419), closes #23969
react: overlay hooks memorised properly to prevent re-renders (#24010) (2c97712), closes #23741
select-popover: non-scrollable popovers no longer have forced overscroll (#23972) (aa4ba89), closes #23971
status-bar: tapping status bar correctly scrolls content to top (#24001) (25eb8cd), closes #20423

Ca5.8.1

5.8.1

patch

September 22 2021

Bug Fixes

angular: select method now has correct types (#23953) (3c1be89), closes #23952
item-sliding: item-sliding accounts for multiple ion-item elements (#23943) (8108edd), closes #19312
label: only inherit color if color property is set on ion-item (#23944) (ae1325c), closes #20125

Ca5.8.0

5.8.0 Calcium

minor

September 15 2021

Bug Fixes

angular: nested tabs now go to correct page (#23902) (1ed9f07), closes #23897
header: role attribute can now be customized (#23888) (8888e2b), closes #21327
react: modal now mounts child component independently of other modals (#23903) (1e13429), closes #23904
tab-bar: safe area padding now added when slot="top" (#23895) (4782969), closes #23893

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

K5.7.0

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)

Ar5.6.14

5.6.14

patch

August 18 2021

Bug Fixes

back-button: MD ripple now accounts for --ripple-color (#23749) (6b18a89), closes #23748
img: correctly determine when to load image when scrolling quickly on slower devices (#23704) (067e621), closes #23703
item-sliding: prevent scrolling during slide gesture (#23774) (e0c4ad3), closes #19564
nav: custom animation is now used correctly (#23779) (f9415ef), closes #23777
vue: using router.go now shows correct view (#23773) (621f4fa), closes #22563

Ar5.6.13

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

Ar5.6.12

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

Ar5.6.11

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

Ar5.6.10

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

Ar5.6.9

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

Ar5.6.8

5.6.8

patch

May 27 2021

Bug Fixes

action-sheet: subheader no longer overlaps action sheet buttons (#23318) (d473a53), closes #23316
all: reflect color property as an attribute for vue (#23345) (dc430af), closes #23323
range: knob can now have an accessible name (#23338) (881dcff), closes #23295
react: remove @ionic/core dependency in @ionic/react-router to resolve yarn install warning (#23351) (36bfa33), closes #23346
react: support history@5 in preparation for react router 6 (#23297) (4da5216), closes #23294
router: guards are now triggered on initial navigation (#23123) (56f6f56), closes #22936
router: redirects now account for query string (#23337) (08a9f3a), closes #23136
skeleton-text: animation no longer jumps on large skeleton text elements (#22697) (1a36922), closes #22694
slides: resolve prototype pollution in swiper v5 (#23344) (a708c41), closes #23342
title: large title scale animation is now correct in rtl mode (#23372) (3d474ec), closes #23371

Ar5.6.7

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

Ar5.6.6

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)

Ar5.6.5

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)

Ar5.6.4

5.6.4

patch

April 8 2021

Bug Fixes

angular: swiping back quickly no longer causes app to get stuck (#23125) (28c52fd), closes #15154
input: inherit aria-label to input (#23159) (61f094d)
react: overlays now correctly unmount any child components after dismissing (#23149) (dee6eb3), closes #23140
react, vue: correct view now chosen when going back inside tabs (#23154) (7203190), closes #23087 #23101
toggle: prevent click event from firing twice (#23146) (42e6c90), closes #23041
vue: account for event name changes in vue 3.0.6+ for overlay components (#23100) (27318cf)
vue: components now integrate properly with vee-validate (#23114) (ba51daf), closes #22886

Ar5.6.3

5.6.3

patch

March 23 2021

Bug Fixes

all: update tslib to resolve export errors (#23092) (0cdd326), closes #23090
react: correctly show ion-back-button when going back (#23069) (1c93b75), closes #22692

Ar5.6.2

5.6.2

patch

March 22 2021

Bug Fixes

item: detail icon now respects rtl mode (#23081) (b04fb6e), closes #23078

Ar5.6.1

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

Ar5.6.0

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

custom-elements: add experimental custom elements build (#22863) (0de75af)
progress-bar: add parts for more design customization (#22938) (e256d3f), closes #20062 #21820
react: add react hooks to control overlay components (#22484) (b83e009)
searchbar: add showClearIcon property (#22759) (215eb5d), closes #22738
vue: add composition API ionic lifecycle hooks (#22970) (dd1c8db), closes #22769

To see more releases, visit GitHub.