feat(transition): omit fixed back-button clone when requested

src/transition/ios.transition.spec.ts

@@ -52,6 +52,35 @@ describe('createIosTransitionAnimation radius', () => {
 });
 
 describe('createIosTransitionAnimation fixed back button', () => {
+  it('omits only its clone when the host opts out', () => {
+    const nav = document.createElement('ion-router-outlet');
+    const enteringEl = createPage(true);
+    const button = document.createElement('ion-back-button');
+    enteringEl.querySelector('ion-header')!.append(button);
+    nav.append(enteringEl);
+    document.body.append(nav);
+
+    Object.defineProperty(button, 'offsetWidth', { configurable: true, value: 40 });
+    const clone = document.createElement('ion-back-button');
+    clone.classList.add('ion-cloned-element');
+    document.body.append(clone);
+
+    const animation = createIosTransitionAnimation({
+      offLeftPercent: 30,
+      getIonPageElement: (element) => element,
+      shouldAnimateFixedBackButton: () => false,
+    })(nav, { enteringEl });
+    animation.progressStart(true);
+
+    expect(clone.parentElement).toBe(document.body);
+    expect(button.style.visibility).toBe('');
+    expect(animation.childAnimations.some((child) => child.elements.includes(enteringEl))).toBe(true);
+
+    animation.destroy();
+    nav.remove();
+    clone.remove();
+  });
+
   it('measures its coordinates when the transition starts', () => {
     const documentDirection = document.dir;
     document.dir = 'rtl';

src/transition/ios.transition.ts

@@ -22,6 +22,8 @@ export interface IosTransitionAnimationConfig {
   radius?: number;
   /** Resolves the ion-page (or fallback) element for a leaving view. */
   getIonPageElement: (element: HTMLElement) => Element;
+  /** Whether the fixed back button participates in the page transition. */
+  shouldAnimateFixedBackButton?: (navEl: HTMLElement) => boolean;
   /**
    * Optional hook invoked after the root animation is fully composed
    * (e.g. ios27 `connectNativeUIShellTransition`).
@@ -277,7 +279,7 @@ export const createIosTransitionAnimation = <TOpts extends IosTransitionAnimatio
         }
       }
 
-      if (topPage) {
+      if (topPage && config.shouldAnimateFixedBackButton?.(navEl) !== false) {
         animateFixedBackButton(
           rootAnimation,
           navEl,