@tarojs/router 3.5.0-canary.1 → 3.5.0

package/dist/animation.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 插入页面动画需要的样式
+ */
+export declare function loadAnimateStyle(ms?: number): void;

package/dist/animation.js

@@ -0,0 +1,29 @@
+/**
+ * 插入页面动画需要的样式
+ */
+export function loadAnimateStyle(ms = 300) {
+    const css = `
+.taro_router .taro_page {
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 100%;
+  height: 100%;
+  background-color: #fff;
+  transform: translate(100%, 0);
+  transition: transform ${ms}ms;
+  z-index: 0;
+}
+
+.taro_router .taro_page.taro_tabbar_page,
+.taro_router .taro_page.taro_page_show.taro_page_stationed {
+  transform: none;
+}
+
+.taro_router .taro_page.taro_page_show {
+  transform: translate(0, 0);
+}`;
+    const style = document.createElement('style');
+    style.innerHTML = css;
+    document.getElementsByTagName('head')[0].appendChild(style);
+}

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+import Taro from '@tarojs/taro';
+export declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
+export declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
+export declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
+export declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
+export declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
+export declare function getCurrentPages(): Taro.Page[];

package/dist/api.js

@@ -0,0 +1,103 @@
+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 { parsePath } from 'history';
+import { history, prependBasename } from './history';
+import { RouterConfig } from './router';
+import stacks from './router/stack';
+import { addLeadingSlash, routesAlias } from './utils';
+function processNavigateUrl(option) {
+    var _a;
+    const pathPieces = parsePath(option.url);
+    // 处理相对路径
+    if ((_a = pathPieces.pathname) === null || _a === void 0 ? void 0 : _a.includes('./')) {
+        const parts = routesAlias.getOrigin(history.location.pathname).split('/');
+        parts.pop();
+        pathPieces.pathname.split('/').forEach((item) => {
+            if (item === '.') {
+                return;
+            }
+            item === '..' ? parts.pop() : parts.push(item);
+        });
+        pathPieces.pathname = parts.join('/');
+    }
+    // 处理自定义路由
+    pathPieces.pathname = routesAlias.getAlias(addLeadingSlash(pathPieces.pathname));
+    // 处理 basename
+    pathPieces.pathname = prependBasename(pathPieces.pathname);
+    // hack fix history v5 bug: https://github.com/remix-run/history/issues/814
+    if (!pathPieces.search)
+        pathPieces.search = '';
+    return pathPieces;
+}
+function navigate(option, method) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const { success, complete, fail } = option;
+            const unListen = history.listen(() => {
+                const res = { errMsg: `${method}:ok` };
+                success === null || success === void 0 ? void 0 : success(res);
+                complete === null || complete === void 0 ? void 0 : complete(res);
+                resolve(res);
+                unListen();
+            });
+            try {
+                if ('url' in option) {
+                    const pathPieces = processNavigateUrl(option);
+                    const state = { timestamp: Date.now() };
+                    if (method === 'navigateTo') {
+                        history.push(pathPieces, state);
+                    }
+                    else if (method === 'redirectTo' || method === 'switchTab') {
+                        history.replace(pathPieces, state);
+                    }
+                    else if (method === 'reLaunch') {
+                        stacks.delta = stacks.length;
+                        history.replace(pathPieces, state);
+                    }
+                }
+                else if (method === 'navigateBack') {
+                    stacks.delta = option.delta;
+                    history.go(-option.delta);
+                }
+            }
+            catch (error) {
+                const res = { errMsg: `${method}:fail ${error.message || error}` };
+                fail === null || fail === void 0 ? void 0 : fail(res);
+                complete === null || complete === void 0 ? void 0 : complete(res);
+                reject(res);
+            }
+        });
+    });
+}
+export function navigateTo(option) {
+    return navigate(option, 'navigateTo');
+}
+export function redirectTo(option) {
+    return navigate(option, 'redirectTo');
+}
+export function navigateBack(option = { delta: 1 }) {
+    if (!option.delta || option.delta < 1) {
+        option.delta = 1;
+    }
+    return navigate(option, 'navigateBack');
+}
+export function switchTab(option) {
+    return navigate(option, 'switchTab');
+}
+export function reLaunch(option) {
+    return navigate(option, 'reLaunch');
+}
+export function getCurrentPages() {
+    if (process.env.NODE_ENV === 'development' && RouterConfig.mode === 'multi') {
+        console.warn('多页面路由模式不支持使用 getCurrentPages 方法！');
+    }
+    const pages = stacks.get();
+    return pages.map(e => (Object.assign(Object.assign({}, e), { route: e.path || '' })));
+}

package/dist/events/resize.d.ts

@@ -0,0 +1,2 @@
+import { PageInstance } from '@tarojs/runtime';
+export declare function bindPageResize(page: PageInstance): void;

package/dist/events/resize.js

@@ -0,0 +1,13 @@
+let pageResizeFn;
+export function bindPageResize(page) {
+    pageResizeFn && window.removeEventListener('resize', pageResizeFn);
+    pageResizeFn = function () {
+        page.onResize && page.onResize({
+            size: {
+                windowHeight: window.innerHeight,
+                windowWidth: window.innerWidth
+            }
+        });
+    };
+    window.addEventListener('resize', pageResizeFn, false);
+}

package/dist/events/scroll.d.ts

@@ -0,0 +1,2 @@
+import { PageInstance } from '@tarojs/runtime';
+export declare function bindPageScroll(page: PageInstance, pageEl: HTMLElement, distance?: number): void;

package/dist/events/scroll.js

@@ -0,0 +1,31 @@
+let pageScrollFn;
+let pageDOM = window;
+export function bindPageScroll(page, pageEl, distance = 50) {
+    pageScrollFn && pageEl.removeEventListener('scroll', pageScrollFn);
+    pageDOM = pageEl;
+    let isReachBottom = false;
+    pageScrollFn = function () {
+        var _a;
+        (_a = page.onPageScroll) === null || _a === void 0 ? void 0 : _a.call(page, {
+            scrollTop: pageDOM instanceof Window ? window.scrollY : pageDOM.scrollTop
+        });
+        if (isReachBottom && getOffset() > distance) {
+            isReachBottom = false;
+        }
+        if (page.onReachBottom &&
+            !isReachBottom &&
+            getOffset() < distance) {
+            isReachBottom = true;
+            page.onReachBottom();
+        }
+    };
+    pageDOM.addEventListener('scroll', pageScrollFn, false);
+}
+function getOffset() {
+    if (pageDOM instanceof Window) {
+        return document.documentElement.scrollHeight - window.scrollY - window.innerHeight;
+    }
+    else {
+        return pageDOM.scrollHeight - pageDOM.scrollTop - pageDOM.clientHeight;
+    }
+}

package/dist/history.d.ts

@@ -0,0 +1,5 @@
+import { IH5RouterConfig } from '@tarojs/taro/types/compile';
+import { History } from 'history';
+export declare let history: History;
+export declare function setHistoryMode(mode?: IH5RouterConfig['mode'], base?: string): void;
+export declare function prependBasename(url?: string): string;

package/dist/history.js

@@ -0,0 +1,100 @@
+import { Action, createBrowserHistory, createHashHistory } from 'history';
+import { RouterConfig } from './router';
+export let history;
+let basename = '/';
+class MpaHistory {
+    constructor() {
+        this.back = window.history.back;
+        this.forward = window.history.forward;
+        this.pushState = this.eventState('pushState');
+        this.replaceState = this.eventState('replaceState');
+    }
+    get location() {
+        return {
+            pathname: window.location.pathname,
+            search: window.location.search,
+            hash: window.location.hash,
+            key: `${window.history.length}`,
+            state: window.history.state
+        };
+    }
+    createHref(_to) {
+        throw new Error('Method not implemented.');
+    }
+    parseUrl(to) {
+        let url = to.pathname || '';
+        if (RouterConfig.isPage(url)) {
+            url += '.html';
+        }
+        if (to.search) {
+            url += `?${to.search}`;
+        }
+        if (to.hash) {
+            url += `#${to.hash}`;
+        }
+        return url;
+    }
+    push(to, _state = {}) {
+        window.location.pathname = this.parseUrl(to);
+        // this.pushState(_state, '', this.parseUrl(to))
+    }
+    replace(to, _state = {}) {
+        window.location.replace(this.parseUrl(to));
+        // this.replaceState(_state, '', this.parseUrl(to))
+    }
+    go(delta) {
+        window.history.go(delta);
+    }
+    listen(listener) {
+        function callback(e) {
+            if (e.action === 'pushState') {
+                listener({ action: Action.Push, location: this.location });
+            }
+            else if (e.action === 'replaceState') {
+                listener({ action: Action.Replace, location: this.location });
+            }
+            else {
+                // NOTE: 这里包括 back、forward、go 三种可能，并非是 POP 事件
+                listener({ action: Action.Pop, location: this.location });
+            }
+        }
+        window.addEventListener('popstate', callback);
+        return () => {
+            window.removeEventListener('popstate', callback);
+        };
+    }
+    block(_blocker) {
+        throw new Error('Method not implemented.');
+    }
+    eventState(action) {
+        return (data, unused, url) => {
+            const wrapper = window.history[action](data, unused, url);
+            const evt = new Event(action);
+            evt.action = action;
+            evt.state = data;
+            evt.unused = unused;
+            evt.url = url;
+            window.dispatchEvent(evt);
+            return wrapper;
+        };
+    }
+}
+export function setHistoryMode(mode, base = '/') {
+    const options = {
+        window
+    };
+    basename = base;
+    if (mode === 'browser') {
+        history = createBrowserHistory(options);
+    }
+    else if (mode === 'multi') {
+        history = new MpaHistory();
+    }
+    else {
+        // default is hash
+        history = createHashHistory(options);
+    }
+}
+export function prependBasename(url = '') {
+    return basename.replace(/\/$/, '') + '/' + url.replace(/^\//, '');
+}

package/dist/index.cjs.d.ts

@@ -0,0 +1,23 @@
+import Taro from "@tarojs/taro";
+import { History } from "history";
+/* eslint-disable dot-notation */
+import { AppInstance } from "@tarojs/runtime";
+import { MpaRouterConfig, SpaRouterConfig } from "../../types/router";
+declare function navigateTo(option: Taro.navigateTo.Option): ReturnType<typeof Taro.navigateTo>;
+declare function redirectTo(option: Taro.redirectTo.Option): ReturnType<typeof Taro.redirectTo>;
+declare function navigateBack(option?: Taro.navigateBack.Option): ReturnType<typeof Taro.navigateBack>;
+declare function switchTab(option: Taro.switchTab.Option): ReturnType<typeof Taro.switchTab>;
+declare function reLaunch(option: Taro.reLaunch.Option): ReturnType<typeof Taro.reLaunch>;
+declare function getCurrentPages(): Taro.Page[];
+declare let history: History;
+// TODO 支持多路由 (APP 生命周期仅触发一次)
+/** Note: 关于多页面应用
+ * - 需要配置路由映射（根目录跳转、404 页面……）
+ * - app.onPageNotFound 事件不支持
+ * - 应用生命周期可能多次触发
+ * - TabBar 会多次加载
+ * - 不支持路由动画
+ */
+declare function createMultiRouter(app: AppInstance, config: MpaRouterConfig, framework?: string): Promise<void>;
+declare function createRouter(app: AppInstance, config: SpaRouterConfig, framework?: string): () => void;
+export { navigateTo, redirectTo, navigateBack, switchTab, reLaunch, getCurrentPages, history, createMultiRouter, createRouter };