@tarojs/router 3.4.8 → 3.5.0-alpha.10

package/dist/router/index.js

@@ -0,0 +1,22 @@
+import { addLeadingSlash } from '../utils';
+export class RouterConfig {
+    static set config(e) {
+        this.__config = e;
+    }
+    static get config() {
+        return this.__config;
+    }
+    static get pages() {
+        return this.config.pages || [];
+    }
+    static get router() {
+        return this.config.router || {};
+    }
+    static get mode() {
+        return this.router.mode || 'hash';
+    }
+    static get customRoutes() { return this.router.customRoutes || {}; }
+    static isPage(url = '') {
+        return this.pages.findIndex(e => addLeadingSlash(e) === url) !== -1;
+    }
+}

package/dist/router/mpa.js

@@ -0,0 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { container, createPageConfig, eventCenter, SERVICE_IDENTIFIER, stringify } from '@tarojs/runtime';
+import { RouterConfig } from '.';
+import MultiPageHandler from './multi-page';
+// TODO 支持多路由 (APP 生命周期仅触发一次)
+/** Note: 关于多页面应用
+ * - 需要配置路由映射（根目录跳转、404 页面……）
+ * - app.onPageNotFound 事件不支持
+ * - 应用生命周期可能多次触发
+ * - TabBar 会多次加载
+ * - 不支持路由动画
+ */
+export function createMultiRouter(app, config, framework) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    return __awaiter(this, void 0, void 0, function* () {
+        RouterConfig.config = config;
+        const handler = new MultiPageHandler(config);
+        const runtimeHooks = container.get(SERVICE_IDENTIFIER.Hooks);
+        const launchParam = handler.getQuery();
+        (_a = app.onLaunch) === null || _a === void 0 ? void 0 : _a.call(app, launchParam);
+        const pathName = config.pageName;
+        const pageConfig = handler.pageConfig;
+        let element;
+        try {
+            element = yield ((_b = pageConfig.load) === null || _b === void 0 ? void 0 : _b.call(pageConfig));
+        }
+        catch (error) {
+            throw new Error(error);
+        }
+        if (!element)
+            return;
+        let enablePullDownRefresh = ((_c = config === null || config === void 0 ? void 0 : config.window) === null || _c === void 0 ? void 0 : _c.enablePullDownRefresh) || false;
+        eventCenter.trigger('__taroRouterChange', {
+            toLocation: {
+                path: pathName
+            }
+        });
+        if (pageConfig) {
+            document.title = (_d = pageConfig.navigationBarTitleText) !== null && _d !== void 0 ? _d : document.title;
+            if (typeof pageConfig.enablePullDownRefresh === 'boolean') {
+                enablePullDownRefresh = pageConfig.enablePullDownRefresh;
+            }
+        }
+        const el = (_e = element.default) !== null && _e !== void 0 ? _e : element;
+        const loadConfig = Object.assign({}, pageConfig);
+        delete loadConfig['path'];
+        delete loadConfig['load'];
+        const page = createPageConfig(enablePullDownRefresh ? (_f = runtimeHooks.createPullDownComponent) === null || _f === void 0 ? void 0 : _f.call(runtimeHooks, el, location.pathname, framework, config.PullDownRefresh) : el, pathName + stringify(launchParam), {}, loadConfig);
+        handler.load(page, pageConfig);
+        (_g = app.onShow) === null || _g === void 0 ? void 0 : _g.call(app, launchParam);
+    });
+}

package/dist/router/multi-page.js

@@ -0,0 +1,111 @@
+import { Current } from '@tarojs/runtime';
+import queryString from 'query-string';
+import { bindPageResize } from '../events/resize';
+import { bindPageScroll } from '../events/scroll';
+import { setHistoryMode } from '../history';
+import { initTabbar } from '../tabbar';
+import { stripBasename } from '../utils';
+export default class MultiPageHandler {
+    constructor(config) {
+        this.config = config;
+        this.mount();
+    }
+    get appId() { return 'app'; }
+    get router() { return this.config.router; }
+    get routerMode() { return this.router.mode || 'hash'; }
+    get customRoutes() { return this.router.customRoutes || {}; }
+    get tabBarList() { var _a; return ((_a = this.config.tabBar) === null || _a === void 0 ? void 0 : _a.list) || []; }
+    get PullDownRefresh() { return this.config.PullDownRefresh; }
+    set pathname(p) { this.router.pathname = p; }
+    get pathname() { return this.router.pathname; }
+    get basename() { return this.router.basename || ''; }
+    get pageConfig() { return this.config.route; }
+    get isTabBar() {
+        var _a;
+        const routePath = stripBasename(this.pathname, this.basename);
+        const pagePath = ((_a = Object.entries(this.customRoutes).find(([, target]) => {
+            if (typeof target === 'string') {
+                return target === routePath;
+            }
+            else if ((target === null || target === void 0 ? void 0 : target.length) > 0) {
+                return target.includes(routePath);
+            }
+            return false;
+        })) === null || _a === void 0 ? void 0 : _a[0]) || routePath;
+        return !!pagePath && this.tabBarList.some(t => t.pagePath === pagePath);
+    }
+    get search() { return location.search.substr(1); }
+    getQuery(search = '', options = {}) {
+        search = search ? `${search}&${this.search}` : this.search;
+        const query = search
+            ? queryString.parse(search)
+            : {};
+        return Object.assign(Object.assign({}, query), options);
+    }
+    mount() {
+        var _a;
+        setHistoryMode(this.routerMode, this.router.basename);
+        (_a = document.getElementById('app')) === null || _a === void 0 ? void 0 : _a.remove();
+        const app = document.createElement('div');
+        app.id = this.appId;
+        app.classList.add('taro_router');
+        if (this.tabBarList.length > 1) {
+            const container = document.createElement('div');
+            container.classList.add('taro-tabbar__container');
+            container.id = 'container';
+            const panel = document.createElement('div');
+            panel.classList.add('taro-tabbar__panel');
+            panel.appendChild(app);
+            container.appendChild(panel);
+            document.body.appendChild(container);
+            initTabbar(this.config);
+        }
+        else {
+            document.body.appendChild(app);
+        }
+    }
+    onReady(page, onLoad = true) {
+        var _a;
+        const pageEl = this.getPageContainer(page);
+        if (pageEl && !(pageEl === null || pageEl === void 0 ? void 0 : pageEl['__isReady'])) {
+            const el = pageEl.firstElementChild;
+            (_a = el === null || el === void 0 ? void 0 : el['componentOnReady']) === null || _a === void 0 ? void 0 : _a.call(el);
+            onLoad && (pageEl['__page'] = page);
+        }
+    }
+    load(page, pageConfig = {}) {
+        var _a;
+        if (!page)
+            return;
+        (_a = page.onLoad) === null || _a === void 0 ? void 0 : _a.call(page, this.getQuery('', page.options), () => {
+            var _a;
+            const pageEl = this.getPageContainer(page);
+            this.isTabBar && (pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.add('taro_tabbar_page'));
+            this.onReady(page, true);
+            (_a = page.onShow) === null || _a === void 0 ? void 0 : _a.call(page);
+            this.bindPageEvents(page, pageEl, pageConfig);
+        });
+    }
+    getPageContainer(page) {
+        var _a;
+        const path = page ? page === null || page === void 0 ? void 0 : page.path : (_a = Current.page) === null || _a === void 0 ? void 0 : _a.path;
+        const id = path === null || path === void 0 ? void 0 : path.replace(/([^a-z0-9\u00a0-\uffff_-])/ig, '\\$1');
+        if (page) {
+            return document.querySelector(`.taro_page#${id}`);
+        }
+        const el = (id
+            ? document.querySelector(`.taro_page#${id}`)
+            : document.querySelector('.taro_page') ||
+                document.querySelector('.taro_router'));
+        return el || window;
+    }
+    bindPageEvents(page, pageEl, config = {}) {
+        var _a;
+        if (!pageEl) {
+            pageEl = this.getPageContainer();
+        }
+        const distance = config.onReachBottomDistance || ((_a = this.config.window) === null || _a === void 0 ? void 0 : _a.onReachBottomDistance) || 50;
+        bindPageScroll(page, pageEl, distance);
+        bindPageResize(page);
+    }
+}

package/dist/router/page.js

@@ -0,0 +1,280 @@
+import { Current, requestAnimationFrame } from '@tarojs/runtime';
+import queryString from 'query-string';
+import { loadAnimateStyle } from '../animation';
+import { bindPageResize } from '../events/resize';
+import { bindPageScroll } from '../events/scroll';
+import { setHistoryMode } from '../history';
+import { initTabbar } from '../tabbar';
+import { addLeadingSlash, routesAlias, stripBasename } from '../utils';
+import stacks from './stack';
+function setDisplay(el, type = '') {
+    if (el) {
+        el.style.display = type;
+    }
+}
+export default class PageHandler {
+    constructor(config) {
+        this.defaultAnimation = { duration: 300, delay: 50 };
+        this.config = config;
+        this.mount();
+    }
+    get appId() { return 'app'; }
+    get router() { return this.config.router; }
+    get routerMode() { return this.router.mode || 'hash'; }
+    get customRoutes() { return this.router.customRoutes || {}; }
+    get routes() { return this.config.routes; }
+    get tabBarList() { var _a; return ((_a = this.config.tabBar) === null || _a === void 0 ? void 0 : _a.list) || []; }
+    get PullDownRefresh() { return this.config.PullDownRefresh; }
+    get animation() { var _a, _b; return (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.animation) !== null && _b !== void 0 ? _b : this.defaultAnimation; }
+    get animationDelay() {
+        var _a;
+        return (typeof this.animation === 'object'
+            ? this.animation.delay
+            : this.animation
+                ? (_a = this.defaultAnimation) === null || _a === void 0 ? void 0 : _a.delay
+                : 0) || 0;
+    }
+    get animationDuration() {
+        var _a;
+        return (typeof this.animation === 'object'
+            ? this.animation.duration
+            : this.animation
+                ? (_a = this.defaultAnimation) === null || _a === void 0 ? void 0 : _a.duration
+                : 0) || 0;
+    }
+    set pathname(p) { this.router.pathname = p; }
+    get pathname() { return this.router.pathname; }
+    get basename() { return this.router.basename || ''; }
+    get homePage() {
+        return this.config.entryPagePath || this.routes[0].path || this.basename;
+    }
+    get pageConfig() {
+        const routePath = stripBasename(this.pathname, this.basename);
+        const homePage = this.homePage;
+        return this.routes.find(r => {
+            var _a;
+            const pagePath = addLeadingSlash(r.path);
+            return [pagePath, homePage].includes(routePath) || ((_a = routesAlias.getConfig(pagePath)) === null || _a === void 0 ? void 0 : _a.includes(routePath));
+        });
+    }
+    get isTabBar() {
+        var _a;
+        const routePath = stripBasename(this.pathname, this.basename);
+        const pagePath = ((_a = Object.entries(this.customRoutes).find(([, target]) => {
+            if (typeof target === 'string') {
+                return target === routePath;
+            }
+            else if ((target === null || target === void 0 ? void 0 : target.length) > 0) {
+                return target.includes(routePath);
+            }
+            return false;
+        })) === null || _a === void 0 ? void 0 : _a[0]) || routePath;
+        return !!pagePath && this.tabBarList.some(t => t.pagePath === pagePath);
+    }
+    isSamePage(page) {
+        const routePath = stripBasename(this.pathname, this.basename);
+        const pagePath = stripBasename(page === null || page === void 0 ? void 0 : page.path, this.basename);
+        return pagePath.startsWith(routePath + '?');
+    }
+    get search() {
+        let search = '?';
+        if (this.routerMode === 'hash') {
+            const idx = location.hash.indexOf('?');
+            if (idx > -1) {
+                search = location.hash.slice(idx);
+            }
+        }
+        else {
+            search = location.search;
+        }
+        return search.substr(1);
+    }
+    getQuery(stamp = 0, search = '', options = {}) {
+        search = search ? `${search}&${this.search}` : this.search;
+        const query = search
+            ? queryString.parse(search, { decode: false })
+            : {};
+        query.stamp = stamp.toString();
+        return Object.assign(Object.assign({}, query), options);
+    }
+    mount() {
+        var _a;
+        setHistoryMode(this.routerMode, this.router.basename);
+        (_a = document.getElementById('app')) === null || _a === void 0 ? void 0 : _a.remove();
+        this.animation && loadAnimateStyle(this.animationDuration);
+        const app = document.createElement('div');
+        app.id = this.appId;
+        app.classList.add('taro_router');
+        if (this.tabBarList.length > 1) {
+            const container = document.createElement('div');
+            container.classList.add('taro-tabbar__container');
+            container.id = 'container';
+            const panel = document.createElement('div');
+            panel.classList.add('taro-tabbar__panel');
+            panel.appendChild(app);
+            container.appendChild(panel);
+            document.body.appendChild(container);
+            initTabbar(this.config);
+        }
+        else {
+            document.body.appendChild(app);
+        }
+    }
+    onReady(page, onLoad = true) {
+        var _a, _b;
+        const pageEl = this.getPageContainer(page);
+        if (pageEl && !(pageEl === null || pageEl === void 0 ? void 0 : pageEl['__isReady'])) {
+            const el = pageEl.firstElementChild;
+            (_b = (_a = el === null || el === void 0 ? void 0 : el['componentOnReady']) === null || _a === void 0 ? void 0 : _a.call(el)) === null || _b === void 0 ? void 0 : _b.then(() => {
+                requestAnimationFrame(() => {
+                    var _a;
+                    (_a = page.onReady) === null || _a === void 0 ? void 0 : _a.call(page);
+                    pageEl['__isReady'] = true;
+                });
+            });
+            onLoad && (pageEl['__page'] = page);
+        }
+    }
+    load(page, pageConfig = {}, stacksIndex = 0) {
+        var _a, _b;
+        if (!page)
+            return;
+        // NOTE: 页面栈推入太晚可能导致 getCurrentPages 无法获取到当前页面实例
+        stacks.push(page);
+        const param = this.getQuery(stacks.length, '', page.options);
+        let pageEl = this.getPageContainer(page);
+        if (pageEl) {
+            setDisplay(pageEl);
+            this.isTabBar && pageEl.classList.add('taro_tabbar_page');
+            this.addAnimation(pageEl, stacksIndex === 0);
+            (_a = page.onShow) === null || _a === void 0 ? void 0 : _a.call(page);
+            this.bindPageEvents(page, pageEl, pageConfig);
+        }
+        else {
+            (_b = page.onLoad) === null || _b === void 0 ? void 0 : _b.call(page, param, () => {
+                var _a;
+                pageEl = this.getPageContainer(page);
+                this.isTabBar && (pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.add('taro_tabbar_page'));
+                this.addAnimation(pageEl, stacksIndex === 0);
+                this.onReady(page, true);
+                (_a = page.onShow) === null || _a === void 0 ? void 0 : _a.call(page);
+                this.bindPageEvents(page, pageEl, pageConfig);
+            });
+        }
+    }
+    unload(page, delta = 1, top = false) {
+        var _a, _b, _c;
+        if (!page)
+            return;
+        stacks.delta = --delta;
+        stacks.pop();
+        if (this.animation && top) {
+            if (this.unloadTimer) {
+                clearTimeout(this.unloadTimer);
+                (_b = (_a = this.lastUnloadPage) === null || _a === void 0 ? void 0 : _a.onUnload) === null || _b === void 0 ? void 0 : _b.call(_a);
+                this.unloadTimer = null;
+            }
+            this.lastUnloadPage = page;
+            const pageEl = this.getPageContainer(page);
+            pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.remove('taro_page_stationed');
+            pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.remove('taro_page_show');
+            this.unloadTimer = setTimeout(() => {
+                var _a, _b;
+                this.unloadTimer = null;
+                (_b = (_a = this.lastUnloadPage) === null || _a === void 0 ? void 0 : _a.onUnload) === null || _b === void 0 ? void 0 : _b.call(_a);
+            }, this.animationDuration);
+        }
+        else {
+            const pageEl = this.getPageContainer(page);
+            pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.remove('taro_page_stationed');
+            pageEl === null || pageEl === void 0 ? void 0 : pageEl.classList.remove('taro_page_show');
+            (_c = page === null || page === void 0 ? void 0 : page.onUnload) === null || _c === void 0 ? void 0 : _c.call(page);
+        }
+        if (delta >= 1)
+            this.unload(stacks.last, delta);
+    }
+    show(page, pageConfig = {}, stacksIndex = 0) {
+        var _a, _b;
+        if (!page)
+            return;
+        const param = this.getQuery(stacks.length, '', page.options);
+        let pageEl = this.getPageContainer(page);
+        if (pageEl) {
+            setDisplay(pageEl);
+            this.addAnimation(pageEl, stacksIndex === 0);
+            (_a = page.onShow) === null || _a === void 0 ? void 0 : _a.call(page);
+            this.bindPageEvents(page, pageEl, pageConfig);
+        }
+        else {
+            (_b = page.onLoad) === null || _b === void 0 ? void 0 : _b.call(page, param, () => {
+                var _a;
+                pageEl = this.getPageContainer(page);
+                this.addAnimation(pageEl, stacksIndex === 0);
+                this.onReady(page, false);
+                (_a = page.onShow) === null || _a === void 0 ? void 0 : _a.call(page);
+                this.bindPageEvents(page, pageEl, pageConfig);
+            });
+        }
+    }
+    hide(page) {
+        var _a;
+        if (!page)
+            return;
+        // NOTE: 修复多页并发问题，此处可能因为路由跳转过快，执行时页面可能还没有创建成功
+        const pageEl = this.getPageContainer(page);
+        if (pageEl) {
+            if (this.hideTimer) {
+                clearTimeout(this.hideTimer);
+                this.hideTimer = null;
+                setDisplay(this.lastHidePage, 'none');
+            }
+            this.lastHidePage = pageEl;
+            this.hideTimer = setTimeout(() => {
+                this.hideTimer = null;
+                setDisplay(this.lastHidePage, 'none');
+            }, this.animationDuration + this.animationDelay);
+            (_a = page.onHide) === null || _a === void 0 ? void 0 : _a.call(page);
+        }
+        else {
+            setTimeout(() => this.hide(page), 0);
+        }
+    }
+    addAnimation(pageEl, first = false) {
+        if (!pageEl)
+            return;
+        if (this.animation && !first) {
+            setTimeout(() => {
+                pageEl.classList.add('taro_page_show');
+                setTimeout(() => {
+                    pageEl.classList.add('taro_page_stationed');
+                }, this.animationDuration);
+            }, this.animationDelay);
+        }
+        else {
+            pageEl.classList.add('taro_page_show');
+            pageEl.classList.add('taro_page_stationed');
+        }
+    }
+    getPageContainer(page) {
+        var _a;
+        const path = page ? page === null || page === void 0 ? void 0 : page.path : (_a = Current.page) === null || _a === void 0 ? void 0 : _a.path;
+        const id = path === null || path === void 0 ? void 0 : path.replace(/([^a-z0-9\u00a0-\uffff_-])/ig, '\\$1');
+        if (page) {
+            return document.querySelector(`.taro_page#${id}`);
+        }
+        const el = (id
+            ? document.querySelector(`.taro_page#${id}`)
+            : document.querySelector('.taro_page') ||
+                document.querySelector('.taro_router'));
+        return el || window;
+    }
+    bindPageEvents(page, pageEl, config = {}) {
+        var _a;
+        if (!pageEl) {
+            pageEl = this.getPageContainer();
+        }
+        const distance = config.onReachBottomDistance || ((_a = this.config.window) === null || _a === void 0 ? void 0 : _a.onReachBottomDistance) || 50;
+        bindPageScroll(page, pageEl, distance);
+        bindPageResize(page);
+    }
+}

package/dist/router/spa.js

@@ -0,0 +1,124 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { container, createPageConfig, Current, eventCenter, SERVICE_IDENTIFIER, stringify } from '@tarojs/runtime';
+import { Action as LocationAction } from 'history';
+import UniversalRouter from 'universal-router';
+import { history, prependBasename } from '../history';
+import PageHandler from './page';
+import stacks from './stack';
+import { addLeadingSlash, routesAlias, stripBasename } from '../utils';
+import { RouterConfig } from '.';
+export function createRouter(app, config, framework) {
+    var _a, _b;
+    RouterConfig.config = config;
+    const handler = new PageHandler(config);
+    const runtimeHooks = container.get(SERVICE_IDENTIFIER.Hooks);
+    routesAlias.set(handler.router.customRoutes);
+    const basename = handler.router.basename;
+    const routes = handler.routes.map(route => {
+        const routePath = addLeadingSlash(route.path);
+        const paths = routesAlias.getAll(routePath);
+        return {
+            path: paths.length < 1 ? routePath : paths,
+            action: route.load
+        };
+    });
+    const router = new UniversalRouter(routes, { baseUrl: basename || '' });
+    const launchParam = handler.getQuery(stacks.length);
+    (_a = app.onLaunch) === null || _a === void 0 ? void 0 : _a.call(app, launchParam);
+    const render = ({ location, action }) => __awaiter(this, void 0, void 0, function* () {
+        var _c, _d, _e, _f, _g;
+        handler.pathname = decodeURI(location.pathname);
+        let element, params;
+        try {
+            const result = yield router.resolve(handler.router.forcePath || handler.pathname);
+            [element, , params] = yield Promise.all(result);
+        }
+        catch (error) {
+            if (error.status === 404) {
+                (_c = app.onPageNotFound) === null || _c === void 0 ? void 0 : _c.call(app, {
+                    path: handler.pathname
+                });
+            }
+            else {
+                throw new Error(error);
+            }
+        }
+        if (!element)
+            return;
+        const pageConfig = handler.pageConfig;
+        let enablePullDownRefresh = ((_d = config === null || config === void 0 ? void 0 : config.window) === null || _d === void 0 ? void 0 : _d.enablePullDownRefresh) || false;
+        eventCenter.trigger('__taroRouterChange', {
+            toLocation: {
+                path: handler.pathname
+            }
+        });
+        if (pageConfig) {
+            document.title = (_e = pageConfig.navigationBarTitleText) !== null && _e !== void 0 ? _e : document.title;
+            if (typeof pageConfig.enablePullDownRefresh === 'boolean') {
+                enablePullDownRefresh = pageConfig.enablePullDownRefresh;
+            }
+        }
+        const currentPage = Current.page;
+        const pathname = handler.pathname;
+        let shouldLoad = false;
+        if (action === 'POP') {
+            // NOTE: 浏览器事件退后多次时，该事件只会被触发一次
+            const prevIndex = stacks.getPrevIndex(pathname);
+            const delta = stacks.getDelta(pathname);
+            handler.unload(currentPage, delta, prevIndex > -1);
+            if (prevIndex > -1) {
+                handler.show(stacks.getItem(prevIndex), pageConfig, prevIndex);
+            }
+            else {
+                shouldLoad = true;
+            }
+        }
+        else {
+            if (handler.isTabBar) {
+                if (handler.isSamePage(currentPage))
+                    return;
+                const prevIndex = stacks.getPrevIndex(pathname, 0);
+                handler.hide(currentPage);
+                if (prevIndex > -1) {
+                    // NOTE: tabbar 页且之前出现过，直接复用
+                    return handler.show(stacks.getItem(prevIndex), pageConfig, prevIndex);
+                }
+            }
+            else if (action === 'REPLACE') {
+                const delta = stacks.getDelta(pathname);
+                // NOTE: 页面路由记录并不会清空，只是移除掉缓存的 stack 以及页面
+                handler.unload(currentPage, delta);
+            }
+            else if (action === 'PUSH') {
+                handler.hide(currentPage);
+            }
+            shouldLoad = true;
+        }
+        if (shouldLoad || stacks.length < 1) {
+            const el = (_f = element.default) !== null && _f !== void 0 ? _f : element;
+            const loadConfig = Object.assign({}, pageConfig);
+            const stacksIndex = stacks.length;
+            delete loadConfig['path'];
+            delete loadConfig['load'];
+            const page = createPageConfig(enablePullDownRefresh ? (_g = runtimeHooks.createPullDownComponent) === null || _g === void 0 ? void 0 : _g.call(runtimeHooks, el, location.pathname, framework, handler.PullDownRefresh) : el, pathname + stringify(handler.getQuery(stacksIndex)), {}, loadConfig);
+            if (params)
+                page.options = params;
+            return handler.load(page, pageConfig, stacksIndex);
+        }
+    });
+    const routePath = stripBasename(history.location.pathname, handler.basename);
+    if (routePath === '/' || routePath === '') {
+        history.replace(prependBasename(handler.homePage + history.location.search));
+    }
+    render({ location: history.location, action: LocationAction.Push });
+    (_b = app.onShow) === null || _b === void 0 ? void 0 : _b.call(app, launchParam);
+    return history.listen(render);
+}

package/dist/router/stack.js

@@ -0,0 +1,59 @@
+class Stacks {
+    constructor() {
+        this.stacks = [];
+        this.backDelta = 0;
+    }
+    set delta(delta) {
+        if (delta > 0) {
+            this.backDelta = delta;
+        }
+        else if (this.backDelta > 0) {
+            --this.backDelta;
+        }
+        else {
+            this.backDelta = 0;
+        }
+    }
+    get delta() {
+        return this.backDelta;
+    }
+    get length() {
+        return this.stacks.length;
+    }
+    get last() {
+        return this.stacks[this.length - 1];
+    }
+    get() {
+        return this.stacks;
+    }
+    getItem(index) {
+        return this.stacks[index];
+    }
+    getLastIndex(pathname, stateWith = 1) {
+        const list = [...this.stacks].reverse();
+        return list.findIndex((page, i) => { var _a; return i >= stateWith && ((_a = page.path) === null || _a === void 0 ? void 0 : _a.replace(/\?.*/g, '')) === pathname; });
+    }
+    getDelta(pathname) {
+        if (this.backDelta >= 1) {
+            return this.backDelta;
+        }
+        const index = this.getLastIndex(pathname);
+        // NOTE: 此处为了修复浏览器后退多级页面，在大量重复路由状况下可能出现判断错误的情况 （增强判断能力只能考虑在 query 中新增参数来判断，暂时搁置）
+        return index > 0 ? index : 1;
+    }
+    getPrevIndex(pathname, stateWith = 1) {
+        const lastIndex = this.getLastIndex(pathname, stateWith);
+        if (lastIndex < 0) {
+            return -1;
+        }
+        return this.length - 1 - lastIndex;
+    }
+    pop() {
+        return this.stacks.pop();
+    }
+    push(page) {
+        return this.stacks.push(page);
+    }
+}
+const stacks = new Stacks();
+export default stacks;