@ionic/angular 8.8.14-dev.11784243422.11f0110c → 8.8.14-dev.11785507167.1f41b13b

package/dist/common/directives/navigation/router-link-delegate.js

@@ -0,0 +1,188 @@
+import { Directive, HostListener, Input, Optional } from '@angular/core';
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/common";
+import * as i2 from "../../providers/nav-controller";
+import * as i3 from "@angular/router";
+/**
+ * Adds support for Ionic routing directions and animations to the base Angular router link directive.
+ *
+ * When the router link is clicked, the directive will assign the direction and
+ * animation so that the routing integration will transition correctly.
+ */
+export class RouterLinkDelegateDirective {
+    locationStrategy;
+    navCtrl;
+    elementRef;
+    router;
+    routerLink;
+    routerDirection = 'forward';
+    routerAnimation;
+    constructor(locationStrategy, navCtrl, elementRef, router, routerLink) {
+        this.locationStrategy = locationStrategy;
+        this.navCtrl = navCtrl;
+        this.elementRef = elementRef;
+        this.router = router;
+        this.routerLink = routerLink;
+    }
+    ngOnInit() {
+        this.updateTargetUrlAndHref();
+        this.updateTabindex();
+        /**
+         * Ionic components like `ion-item` render a native anchor in their shadow DOM,
+         * so a modifier click (ctrl/meta/shift/alt) or a non-`_self` target should let
+         * the browser handle the navigation natively (new tab, new window, download)
+         * instead of navigating in-app.
+         *
+         * We listen in the capture phase so this runs before Angular's `RouterLink`
+         * handler and our own bubble-phase `onClick`. On a native-navigation intent it
+         * stops propagation to cancel the in-app navigation, but leaves `preventDefault`
+         * alone so the native anchor can still act.
+         */
+        this.elementRef.nativeElement.addEventListener('click', this.onCaptureClick, { capture: true });
+    }
+    ngOnChanges() {
+        this.updateTargetUrlAndHref();
+    }
+    ngOnDestroy() {
+        this.elementRef.nativeElement.removeEventListener('click', this.onCaptureClick, { capture: true });
+    }
+    onCaptureClick = (ev) => {
+        if (this.opensNatively(ev)) {
+            ev.stopImmediatePropagation();
+        }
+    };
+    /**
+     * True when the browser should handle the click natively instead of routing
+     * in-app: a modifier was held (ctrl/meta/shift/alt), or the host targets
+     * something other than `_self`. This mirrors the modifier set Angular's own
+     * `RouterLink` guards on, so an Ionic `routerLink` behaves like a plain anchor
+     * for new-tab, new-window, and download intents.
+     */
+    opensNatively(ev) {
+        if (ev instanceof MouseEvent && (ev.ctrlKey || ev.metaKey || ev.shiftKey || ev.altKey)) {
+            return true;
+        }
+        const target = this.elementRef.nativeElement.target;
+        return target != null && target !== '' && target !== '_self';
+    }
+    /**
+     * The `tabindex` is set to `0` by default on the host element when
+     * the `routerLink` directive is used. This causes issues with Ionic
+     * components that wrap an `a` or `button` element, such as `ion-item`.
+     * See issue https://github.com/angular/angular/issues/28345
+     *
+     * This method removes the `tabindex` attribute from the host element
+     * to allow the Ionic component to manage the focus state correctly.
+     */
+    updateTabindex() {
+        // Ionic components that render a native anchor or button element
+        const ionicComponents = [
+            'ION-BACK-BUTTON',
+            'ION-BREADCRUMB',
+            'ION-BUTTON',
+            'ION-CARD',
+            'ION-FAB-BUTTON',
+            'ION-ITEM',
+            'ION-ITEM-OPTION',
+            'ION-MENU-BUTTON',
+            'ION-SEGMENT-BUTTON',
+            'ION-TAB-BUTTON',
+        ];
+        const hostElement = this.elementRef.nativeElement;
+        if (ionicComponents.includes(hostElement.tagName)) {
+            if (hostElement.getAttribute('tabindex') === '0') {
+                hostElement.removeAttribute('tabindex');
+            }
+        }
+    }
+    updateTargetUrlAndHref() {
+        if (this.routerLink?.urlTree) {
+            const href = this.locationStrategy.prepareExternalUrl(this.router.serializeUrl(this.routerLink.urlTree));
+            this.elementRef.nativeElement.href = href;
+        }
+    }
+    /**
+     * @internal
+     */
+    onClick(ev) {
+        this.navCtrl.setDirection(this.routerDirection, undefined, undefined, this.routerAnimation);
+        /**
+         * This prevents the browser from
+         * performing a page reload when pressing
+         * an Ionic component with routerLink.
+         * The page reload interferes with routing
+         * and causes ion-back-button to disappear
+         * since the local history is wiped on reload.
+         */
+        ev.preventDefault();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: RouterLinkDelegateDirective, deps: [{ token: i1.LocationStrategy }, { token: i2.NavController }, { token: i0.ElementRef }, { token: i3.Router }, { token: i3.RouterLink, optional: true }], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.0", type: RouterLinkDelegateDirective, isStandalone: true, selector: ":not(a):not(area)[routerLink]", inputs: { routerDirection: "routerDirection", routerAnimation: "routerAnimation" }, host: { listeners: { "click": "onClick($event)" } }, usesOnChanges: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: RouterLinkDelegateDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: ':not(a):not(area)[routerLink]',
+                }]
+        }], ctorParameters: () => [{ type: i1.LocationStrategy }, { type: i2.NavController }, { type: i0.ElementRef }, { type: i3.Router }, { type: i3.RouterLink, decorators: [{
+                    type: Optional
+                }] }], propDecorators: { routerDirection: [{
+                type: Input
+            }], routerAnimation: [{
+                type: Input
+            }], onClick: [{
+                type: HostListener,
+                args: ['click', ['$event']]
+            }] } });
+export class RouterLinkWithHrefDelegateDirective {
+    locationStrategy;
+    navCtrl;
+    elementRef;
+    router;
+    routerLink;
+    routerDirection = 'forward';
+    routerAnimation;
+    constructor(locationStrategy, navCtrl, elementRef, router, routerLink) {
+        this.locationStrategy = locationStrategy;
+        this.navCtrl = navCtrl;
+        this.elementRef = elementRef;
+        this.router = router;
+        this.routerLink = routerLink;
+    }
+    ngOnInit() {
+        this.updateTargetUrlAndHref();
+    }
+    ngOnChanges() {
+        this.updateTargetUrlAndHref();
+    }
+    updateTargetUrlAndHref() {
+        if (this.routerLink?.urlTree) {
+            const href = this.locationStrategy.prepareExternalUrl(this.router.serializeUrl(this.routerLink.urlTree));
+            this.elementRef.nativeElement.href = href;
+        }
+    }
+    /**
+     * @internal
+     */
+    onClick() {
+        this.navCtrl.setDirection(this.routerDirection, undefined, undefined, this.routerAnimation);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: RouterLinkWithHrefDelegateDirective, deps: [{ token: i1.LocationStrategy }, { token: i2.NavController }, { token: i0.ElementRef }, { token: i3.Router }, { token: i3.RouterLink, optional: true }], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.0", type: RouterLinkWithHrefDelegateDirective, isStandalone: true, selector: "a[routerLink],area[routerLink]", inputs: { routerDirection: "routerDirection", routerAnimation: "routerAnimation" }, host: { listeners: { "click": "onClick()" } }, usesOnChanges: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: RouterLinkWithHrefDelegateDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'a[routerLink],area[routerLink]',
+                }]
+        }], ctorParameters: () => [{ type: i1.LocationStrategy }, { type: i2.NavController }, { type: i0.ElementRef }, { type: i3.Router }, { type: i3.RouterLink, decorators: [{
+                    type: Optional
+                }] }], propDecorators: { routerDirection: [{
+                type: Input
+            }], routerAnimation: [{
+                type: Input
+            }], onClick: [{
+                type: HostListener,
+                args: ['click']
+            }] } });
+//# sourceMappingURL=router-link-delegate.js.map

package/dist/common/directives/navigation/router-link-delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-link-delegate.js","sourceRoot":"","sources":["../../../../src/common/directives/navigation/router-link-delegate.ts"],"names":[],"mappings":"AACA,OAAO,EAA4C,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;;;;;AAMnH;;;;;GAKG;AAIH,MAAM,OAAO,2BAA2B;IAQ5B;IACA;IACA;IACA;IACY;IAVtB,eAAe,GAAoB,SAAS,CAAC;IAG7C,eAAe,CAAoB;IAEnC,YACU,gBAAkC,EAClC,OAAsB,EACtB,UAAsB,EACtB,MAAc,EACF,UAAuB;QAJnC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,YAAO,GAAP,OAAO,CAAe;QACtB,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAQ;QACF,eAAU,GAAV,UAAU,CAAa;IAC1C,CAAC;IAEJ,QAAQ;QACN,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB;;;;;;;;;;WAUG;QACH,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,WAAW;QACT,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED,WAAW;QACT,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrG,CAAC;IAEO,cAAc,GAAG,CAAC,EAAS,EAAQ,EAAE;QAC3C,IAAI,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,EAAE,CAAC,wBAAwB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC,CAAC;IAEF;;;;;;OAMG;IACK,aAAa,CAAC,EAAS;QAC7B,IAAI,EAAE,YAAY,UAAU,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC;QACpD,OAAO,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,OAAO,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACK,cAAc;QACpB,iEAAiE;QACjE,MAAM,eAAe,GAAG;YACtB,iBAAiB;YACjB,gBAAgB;YAChB,YAAY;YACZ,UAAU;YACV,gBAAgB;YAChB,UAAU;YACV,iBAAiB;YACjB,iBAAiB;YACjB,oBAAoB;YACpB,gBAAgB;SACjB,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAElD,IAAI,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,IAAI,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;gBACjD,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,sBAAsB;QAC5B,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YACzG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IAEH,OAAO,CAAC,EAAW;QACjB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAE5F;;;;;;;WAOG;QACH,EAAE,CAAC,cAAc,EAAE,CAAC;IACtB,CAAC;uGAtHU,2BAA2B;2FAA3B,2BAA2B;;2FAA3B,2BAA2B;kBAHvC,SAAS;mBAAC;oBACT,QAAQ,EAAE,+BAA+B;iBAC1C;;0BAaI,QAAQ;;sBAXV,KAAK;;sBAGL,KAAK;;sBAqGL,YAAY;uBAAC,OAAO,EAAE,CAAC,QAAQ,CAAC;;AAmBnC,MAAM,OAAO,mCAAmC;IAQpC;IACA;IACA;IACA;IACY;IAVtB,eAAe,GAAoB,SAAS,CAAC;IAG7C,eAAe,CAAoB;IAEnC,YACU,gBAAkC,EAClC,OAAsB,EACtB,UAAsB,EACtB,MAAc,EACF,UAAuB;QAJnC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,YAAO,GAAP,OAAO,CAAe;QACtB,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAQ;QACF,eAAU,GAAV,UAAU,CAAa;IAC1C,CAAC;IAEJ,QAAQ;QACN,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED,WAAW;QACT,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAEO,sBAAsB;QAC5B,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YACzG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IAEH,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9F,CAAC;uGApCU,mCAAmC;2FAAnC,mCAAmC;;2FAAnC,mCAAmC;kBAH/C,SAAS;mBAAC;oBACT,QAAQ,EAAE,gCAAgC;iBAC3C;;0BAaI,QAAQ;;sBAXV,KAAK;;sBAGL,KAAK;;sBA6BL,YAAY;uBAAC,OAAO"}

package/dist/common/directives/navigation/router-outlet.d.ts

@@ -0,0 +1,104 @@
+import { Location } from '@angular/common';
+import { ComponentRef, ElementRef, NgZone, OnDestroy, OnInit, EventEmitter, EnvironmentInjector } from '@angular/core';
+import type { Provider } from '@angular/core';
+import { OutletContext, Router, ActivatedRoute, Data } from '@angular/router';
+import type { AnimationBuilder } from '@ionic/core/components';
+import { RouteView, StackDidChangeEvent, StackWillChangeEvent } from './stack-utils';
+import * as i0 from "@angular/core";
+export declare abstract class IonRouterOutlet implements OnDestroy, OnInit {
+    readonly parentOutlet?: IonRouterOutlet | undefined;
+    abstract outletContent: any;
+    nativeEl: HTMLIonRouterOutletElement;
+    activatedView: RouteView | null;
+    tabsPrefix: string | undefined;
+    private _swipeGesture?;
+    private stackCtrl;
+    private proxyMap;
+    private currentActivatedRoute$;
+    private activated;
+    /** @internal */
+    get activatedComponentRef(): ComponentRef<any> | null;
+    private _activatedRoute;
+    /**
+     * The name of the outlet
+     */
+    name: string;
+    /** @internal */
+    stackWillChange: EventEmitter<StackWillChangeEvent>;
+    /** @internal */
+    stackDidChange: EventEmitter<StackDidChangeEvent>;
+    activateEvents: EventEmitter<any>;
+    deactivateEvents: EventEmitter<any>;
+    private parentContexts;
+    private location;
+    private environmentInjector;
+    private inputBinder;
+    /** @nodoc */
+    readonly supportsBindingToComponentInputs = true;
+    private config;
+    private navCtrl;
+    set animation(animation: AnimationBuilder);
+    set animated(animated: boolean);
+    set swipeGesture(swipe: boolean);
+    constructor(name: string, tabs: string, commonLocation: Location, elementRef: ElementRef, router: Router, zone: NgZone, activatedRoute: ActivatedRoute, parentOutlet?: IonRouterOutlet | undefined);
+    ngOnDestroy(): void;
+    getContext(): OutletContext | null;
+    ngOnInit(): void;
+    private initializeOutletWithName;
+    get isActivated(): boolean;
+    get component(): Record<string, unknown>;
+    get activatedRoute(): ActivatedRoute;
+    get activatedRouteData(): Data;
+    /**
+     * Called when the `RouteReuseStrategy` instructs to detach the subtree
+     */
+    detach(): ComponentRef<any>;
+    /**
+     * Called when the `RouteReuseStrategy` instructs to re-attach a previously detached subtree
+     */
+    attach(_ref: ComponentRef<any>, _activatedRoute: ActivatedRoute): void;
+    deactivate(): void;
+    activateWith(activatedRoute: ActivatedRoute, environmentInjector: EnvironmentInjector | null): void;
+    /**
+     * Returns `true` if there are pages in the stack to go back.
+     */
+    canGoBack(deep?: number, stackId?: string): boolean;
+    /**
+     * Resolves to `true` if it the outlet was able to sucessfully pop the last N pages.
+     */
+    pop(deep?: number, stackId?: string): Promise<boolean>;
+    /**
+     * Returns the URL of the active page of each stack.
+     */
+    getLastUrl(stackId?: string): string | undefined;
+    /**
+     * Returns the RouteView of the active page of each stack.
+     * @internal
+     */
+    getLastRouteView(stackId?: string): RouteView | undefined;
+    /**
+     * Returns the root view in the tab stack.
+     * @internal
+     */
+    getRootView(stackId?: string): RouteView | undefined;
+    /**
+     * Returns the active stack ID. In the context of ion-tabs, it means the active tab.
+     */
+    getActiveStackId(): string | undefined;
+    /**
+     * Since the activated route can change over the life time of a component in an ion router outlet, we create
+     * a proxy so that we can update the values over time as a user navigates back to components already in the stack.
+     */
+    private createActivatedRouteProxy;
+    /**
+     * Create a wrapped observable that will switch to the latest activated route matched by the given component
+     */
+    private proxyObservable;
+    /**
+     * Updates the activated route proxy for the given component to the new incoming router state
+     */
+    private updateActivatedRouteProxy;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IonRouterOutlet, [{ attribute: "name"; }, { attribute: "tabs"; optional: true; }, null, null, null, null, null, { optional: true; skipSelf: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<IonRouterOutlet, "ion-router-outlet", ["outlet"], { "animated": { "alias": "animated"; "required": false; }; "animation": { "alias": "animation"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "swipeGesture": { "alias": "swipeGesture"; "required": false; }; "name": { "alias": "name"; "required": false; }; }, { "stackWillChange": "stackWillChange"; "stackDidChange": "stackDidChange"; "activateEvents": "activate"; "deactivateEvents": "deactivate"; }, never, never, true, never>;
+}
+export declare const provideComponentInputBinding: () => Provider;