ionic-framework/BREAKING.md

Breaking Changes

This is a comprehensive list of the breaking changes introduced in the major version releases of Ionic Framework.

Versions

• Version 8.x
• Version 7.x
• Version 6.x
• Version 5.x
• Version 4.x
• Legacy

Version 8.x

• Browser and Platform Support
• Components
  • Content
  • Datetime
  • Picker

Browser and Platform Support

This section details the desktop browser, JavaScript framework, and mobile platform versions that are supported by Ionic 8.

Minimum Browser Versions

Desktop Browser	Supported Versions
Chrome	89+
Safari	15+
Firefox	75+
Edge	89+

Minimum JavaScript Framework Versions

Framework	Supported Version
Angular	16+
React	17+
Vue	3.0.6+

Minimum Mobile Platform Versions

Platform	Supported Version
iOS	15+
Android	5.1+ with Chromium 89+

Components

Content

• Content no longer sets the --background custom property when the .outer-content class is set on the host.

Datetime

• The CSS shadow part for month-year-button has been changed to target a button element instead of ion-item. Developers should verify their UI renders as expected for the month/year toggle button inside of ion-datetime.
  • Developers using the CSS variables available on ion-item will need to migrate their CSS to use CSS properties. For example:

    ion-datetime::part(month-year-button) {
    -  --background: red;
    
    +  background: red;
    }
    

Picker

• ion-picker and ion-picker-column have been renamed to ion-picker-legacy and ion-picker-legacy-column, respectively. This change was made to accommodate the new inline picker component while allowing developers to continue to use the legacy picker during this migration period.
  • Only the component names have been changed. Usages such as ion-picker or IonPicker should be changed to ion-picker-legacy and IonPickerLegacy, respectively.
  • Non-component usages such as pickerController or useIonPicker remain unchanged. The new picker displays inline with your page content and does not have equivalents for these non-component usages.