Skip to content

BREAKING.md

Latest commit

 

History

History
58 lines (38 loc) · 2.03 KB

BREAKING.md

File metadata and controls

58 lines (38 loc) · 2.03 KB

Breaking Changes

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

Versions

Version 9.x

Components

Legacy Picker

  • ion-picker-legacy and ion-picker-legacy-column have been removed. The legacy picker component has been replaced with an inline picker component.
    • Usages such as ion-picker-legacy or IonPickerLegacy should be changed to ion-picker and IonPicker, respectively.

Router Outlet

ion-router-outlet now exposes a swipeGesture property that controls the swipe-to-go-back gesture per outlet. This property defaults to true in "ios" mode and false in "md" mode.

swipeBackEnabled Config Behavior Change

In React and Vue, the swipeBackEnabled config option is now read once when the outlet mounts. Apps that dynamically toggle this config value at runtime should migrate to the swipeGesture property instead:

React:

- setupIonicReact({ swipeBackEnabled: someCondition });
+ <IonRouterOutlet swipeGesture={someCondition} />

Vue:

- createApp(App).use(IonicVue, { swipeBackEnabled: someCondition })
+ <ion-router-outlet :swipe-gesture="someCondition" />

Disabling Swipe-to-Go-Back

To disable the gesture on a specific outlet, set swipeGesture to false:

<IonRouterOutlet swipeGesture={false} />

The swipeBackEnabled config option is still respected as the initial default and does not need to change for apps that set it once at startup.