Skip to content

BREAKING.md

Latest commit

 

History

History
60 lines (40 loc) · 2.41 KB

BREAKING.md

File metadata and controls

60 lines (40 loc) · 2.41 KB
Raw

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.
  • Remove any usages of pickerController. If using React, remove any usages of the useIonPicker hook. These controller-based APIs have been removed. Use the inline picker component instead.
  • Remove any usages of the PickerOptions, PickerButton, PickerColumn, and PickerColumnOption type exports. These types were associated with the legacy picker and have been removed.

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.