feat(router-outlet): add swipeGesture prop to control swipe-to-go-back per outlet

[ShaneK]

Issue number: resolves internal

---

What is the current behavior?

The swipe-to-go-back gesture on ion-router-outlet is controlled differently across frameworks:

• React and Vue check the swipeBackEnabled config option on every swipe attempt in their framework wrappers (StackManager.canStart() and IonRouterOutlet.canStart())
• Angular reads the config once at mount and controls the gesture through its directive's swipeGesture setter
• There is no public, per-outlet property to enable or disable the gesture. The only mechanism is the global swipeBackEnabled config option

What is the new behavior?

ion-router-outlet now exposes a public swipeGesture property in core that controls the swipe-to-go-back gesture per outlet instance. It defaults to true in "ios" mode and false in "md" mode, matching existing behavior.

• The swipeBackEnabled config is read once when the outlet mounts (as the default for swipeGesture) rather than checked on every swipe attempt
• The config check has been removed from React's StackManager and Vue's IonRouterOutlet -- core now owns this state
• Angular's directive forwards the value to the core component's swipeGesture property for consistency
• Apps can disable the gesture on a specific outlet: <IonRouterOutlet swipeGesture={false} />
• Apps that set swipeBackEnabled once at startup require no changes

Does this introduce a breaking change?

• Yes
• No

Other information

I tried to align the updates to the BREAKING.md documents with the RR6 PR's changes to it to prevent issues from merging as much as possible

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ionic-framework	Ready	Preview, Comment	Apr 1, 2026 9:26pm