Method _navigateCore

packages/core/ui/frame/index.ios.ts:114–242

(backstackEntry: BackstackEntry)

	// !!! BECAUSE THE PARAMETER TYPE IS EVALUATED WITH TYPEOF
	@profile
	public _navigateCore(backstackEntry: BackstackEntry) {
		super._navigateCore(backstackEntry);

		const viewController: UIViewController = backstackEntry.resolvedPage.ios;
		if (!viewController) {
			throw new Error('Required page does not have a viewController created.');
		}

		const clearHistory = backstackEntry.entry.clearHistory;
		if (clearHistory) {
			navDepth = -1;
		}

		const isReplace = this._executingContext && this._executingContext.navigationType === NavigationType.replace;
		if (!isReplace) {
			navDepth++;
		}

		let navigationTransition: NavigationTransition;
		const animated = this.currentPage ? this._getIsAnimatedNavigation(backstackEntry.entry) : false;
		if (animated) {
			navigationTransition = this._getNavigationTransition(backstackEntry.entry);
			if (navigationTransition) {
				viewController[TRANSITION] = navigationTransition;
			}
		} else {
			//https://github.com/NativeScript/NativeScript/issues/1787
			viewController[TRANSITION] = { name: NON_ANIMATED_TRANSITION };
		}

		if (!navControllerDelegate) {
			navControllerDelegate = UINavigationControllerDelegateImpl.new();
		}

		this._ios.controller.delegate = navControllerDelegate;
		viewController[DELEGATE] = navControllerDelegate;

		const nativeTransition = _getNativeTransition(navigationTransition, true, this.direction);
		if (!nativeTransition && navigationTransition) {
			if (navigationTransition.instance) {
				this.transitionId = navigationTransition.instance.id;
				const transitionState = SharedTransition.getState(this.transitionId);
				if (transitionState?.interactive?.dismiss) {
					// interactive transitions via gestures
					// TODO - allow users to define their own custom gesture dismissals
					navigationTransition.instance.setupInteractiveGesture(() => {
						this._ios.controller.popViewControllerAnimated(true);
					}, this);
				}
			}
		}

		backstackEntry[NAV_DEPTH] = navDepth;
		viewController[ENTRY] = backstackEntry;

		if (!animated && SDK_VERSION > 10) {
			// Reset back button title before pushing view controller to prevent
			// displaying default 'back' title (when NavigaitonButton custom title is set).