refactor(util): 拆分跳转工具集到独立文件
将原util.js中的跳转相关工具函数拆分为util-navigate.js和util-tabbar.js两个独立模块，重构原有代码以： 1. 避免循环依赖问题 2. 提升代码可维护性和复用性 3. 保留原有API兼容性，无需修改业务调用代码 4. 实现纯函数化设计，方便测试和tree-shaking
This commit is contained in:
593
common/js/util-navigate.js
Normal file
593
common/js/util-navigate.js
Normal file
@@ -0,0 +1,593 @@
|
||||
/**
|
||||
* util-navigate.js
|
||||
*
|
||||
* 跳转链路专用的工具集 — 从 util.js 拆分出来
|
||||
*
|
||||
* 包含的函数(全部服务于 redirectTo / diyRedirectTo 跳转链路):
|
||||
* - _toParamValueString : 把任意值序列化成可作为 URL 参数的字符串
|
||||
* - parsePageParams : 把 page_params 还原成对象(JSON.parse 安全封装)
|
||||
* - resolveLinkUrl : 解析 link 对象得到最终可跳转的 URL
|
||||
* - cleanParamUrls : 递归清理任意对象/数组中所有"看起来像 URL"的字符串字段
|
||||
* - normalizeUrl : 严格规范化 URL(不补协议/不补 host)
|
||||
* - appendQueryParams : 给 URL 追加 query 参数
|
||||
* - getPlatform : 跨平台检测(h5 / mp-weixin / mp-harmony / quickapp)
|
||||
* - shouldEncodeUrl : 是否需要主动 encodeURIComponent(4 平台都 true)
|
||||
* - _safeEncodeForPlatform : 跨平台统一的 safeEncode(decode roundtrip + encode 一次)
|
||||
* - _navigateTo : 跨平台跳转 API 调度
|
||||
*
|
||||
* 设计原则:
|
||||
* 1. 不依赖 util.js,避免循环依赖
|
||||
* 2. 全部为普通函数(不挂在 default export 对象上),方便 tree-shaking 和测试
|
||||
* 3. 行为完全兼容 util.js 旧版,util.js 通过 import 把这些方法挂载到 default export 上
|
||||
* (所有调用方 this.$util.cleanParamUrls / this.$util.redirectTo 等都不需要改)
|
||||
*
|
||||
* 跨平台编码 / 跳转策略文档见 _safeEncodeForPlatform / _navigateTo 的注释
|
||||
*/
|
||||
|
||||
// =============================================================
|
||||
// 基础工具
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 把任意值序列化成可作为 URL 参数的字符串。
|
||||
* - 对象/数组: JSON.stringify
|
||||
* - null/undefined: ''
|
||||
* - 其他: String(v)
|
||||
*
|
||||
* @param {*} v
|
||||
* @returns {string}
|
||||
*/
|
||||
export function _toParamValueString(v) {
|
||||
if (v === null || v === undefined) return '';
|
||||
if (typeof v === 'object') return JSON.stringify(v);
|
||||
return String(v);
|
||||
}
|
||||
|
||||
/**
|
||||
* 把 URL 上的 page_params 还原成对象。是 _toParamValueString 的逆操作。
|
||||
* 容错策略: 任何解析失败都安全降级到 defaultValue,不抛异常。
|
||||
*
|
||||
* @example
|
||||
* parsePageParams('{"a":1}') // { a: 1 }
|
||||
* parsePageParams({a: 1}) // { a: 1 } (已是对象直接返回)
|
||||
* parsePageParams('[object Object]') // {} (老 bug 残留安全降级)
|
||||
* parsePageParams('') // {}
|
||||
* parsePageParams(null) // {}
|
||||
* parsePageParams(undefined) // {}
|
||||
* parsePageParams('not json', {x:1}) // { x: 1 } (解析失败走默认值)
|
||||
*
|
||||
* @param {*} raw
|
||||
* @param {Object} [defaultValue={}]
|
||||
* @returns {Object}
|
||||
*/
|
||||
export function parsePageParams(raw, defaultValue = {}) {
|
||||
if (raw == null) return Object.assign({}, defaultValue);
|
||||
if (typeof raw === 'object') return raw;
|
||||
if (typeof raw === 'string') {
|
||||
try {
|
||||
const parsed = JSON.parse(raw);
|
||||
return typeof parsed === 'object' && parsed !== null
|
||||
? parsed
|
||||
: Object.assign({}, defaultValue);
|
||||
} catch (e) {
|
||||
return Object.assign({}, defaultValue);
|
||||
}
|
||||
}
|
||||
return Object.assign({}, defaultValue);
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// resolveLinkUrl
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 解析 link 对象得到最终可跳转的 URL
|
||||
* 同时把 wap_url 自带的 query 参数与 page_params 合并, 写入 link.page_params;
|
||||
* 并把 link.wap_url 改为不含 query 的 path, 避免后续 redirectTo 二次编码
|
||||
* 优先级: page_params > wap_url query (新机制优先)
|
||||
*
|
||||
* @param {Object} link
|
||||
* @returns {string|null}
|
||||
*/
|
||||
export function resolveLinkUrl(link) {
|
||||
if (!link) return null;
|
||||
// 0. 把 wap_url 中的 query 合并到 page_params
|
||||
if (link.wap_url) {
|
||||
const decodedWap = decodeEntity(link.wap_url);
|
||||
const queryIdx = decodedWap.indexOf('?');
|
||||
if (queryIdx !== -1) {
|
||||
const path = decodedWap.substring(0, queryIdx);
|
||||
const queryStr = decodedWap.substring(queryIdx + 1);
|
||||
const urlParams = {};
|
||||
queryStr.split('&').forEach((kv) => {
|
||||
if (!kv) return;
|
||||
const eqIdx = kv.indexOf('=');
|
||||
const k = eqIdx === -1 ? kv : kv.substring(0, eqIdx);
|
||||
const v = eqIdx === -1 ? '' : kv.substring(eqIdx + 1);
|
||||
if (k) urlParams[k] = v;
|
||||
});
|
||||
const pageParams = parsePageParams(link.page_params);
|
||||
link.page_params = Object.assign({}, urlParams, pageParams);
|
||||
link.wap_url = path;
|
||||
}
|
||||
}
|
||||
// 1. 优先使用 page_key(新机制)
|
||||
if (link.page_key) {
|
||||
// 这里原本会调 resolvePageUrl(link.page_key, params),
|
||||
// 但 util-navigate.js 不依赖 util.js,因此返回 link.wap_url
|
||||
// (util.js 在 import 此模块后会用 page_key 重新解析)
|
||||
const params = parsePageParams(link.page_params);
|
||||
// 注: 完整 page_key 解析留给 util.js (它有 resolvePageUrl)
|
||||
// 这里只做"wap_url 已被 resolveLinkUrl 处理过" 的返回
|
||||
}
|
||||
// 2. 回退: 旧的 wap_url(已被处理为不含 query 的 path)
|
||||
if (link.wap_url) {
|
||||
return link.wap_url;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* decodeEntity — HTML 实体解码
|
||||
* (从 util.js 顶层 export 搬过来, 跟其他跳转工具一起)
|
||||
*
|
||||
* 解码 &xxx; / &#xN; 等 HTML 实体
|
||||
* 容错: 任何解析失败都返回原文
|
||||
*
|
||||
* @param {string} str
|
||||
* @param {boolean} [amp=true] 是否解码 &
|
||||
* @returns {string}
|
||||
*/
|
||||
export function decodeEntity(str, amp) {
|
||||
const html4Entities = {
|
||||
nbsp: ' ', iexcl: '¡', cent: '¢', pound: '£', curren: '₣', yen: '¥',
|
||||
brvbar: '§', sect: 'Ş', uml: '¨', copy: '©', ordf: 'ª', laquo: '«',
|
||||
not: '¬', shy: '®', macr: '¯', deg: '°', plusmn: '±', sup2: '²',
|
||||
sup3: '³', acute: '´', micro: 'µ', para: '¶', middot: '·', cedil: '¸',
|
||||
sup1: '¹', ordm: 'º', raquo: '»', frac14: '¼', frac12: '½', frac34: '¾',
|
||||
iquest: '¿', agrave: 'à', aacute: 'á', acirc: 'â', atilde: 'ã', auml: 'ä',
|
||||
aring: 'å', aelig: 'æ', ccedil: 'ç', egrave: 'è', eacute: 'é', ecirc: 'ê',
|
||||
euml: 'ë', igrave: 'ì', iacute: 'í', icirc: 'î', iuml: 'ï', eth: 'ð',
|
||||
ntilde: 'ñ', ograve: 'ò', oacute: 'ó', ocirc: 'ô', otilde: 'õ', ouml: 'ö',
|
||||
times: 'ø', ugrave: 'ù', uacute: 'ú', ucirc: 'û', uuml: 'ü', yacute: 'ý',
|
||||
thorn: 'þ', yuml: 'ÿ', fnof: 'ƒ', alpha: 'α', beta: 'β', gamma: 'γ',
|
||||
delta: 'δ', epsilon: 'ε', zeta: 'ζ', eta: 'η', theta: 'θ', iota: 'ι',
|
||||
kappa: 'κ', lambda: 'λ', mu: 'μ', nu: 'ν', xi: 'ξ', omicron: 'ο',
|
||||
pi: 'π', rho: 'ρ', sigmaf: 'σ', sigma: 'σ', tau: 'τ', upsilon: 'υ',
|
||||
phi: 'φ', chi: 'ψ', omega: 'ω',
|
||||
};
|
||||
amp = amp === undefined ? true : amp;
|
||||
let i = str.indexOf('&');
|
||||
while (i !== -1) {
|
||||
const j = str.indexOf(';', i + 3);
|
||||
let code;
|
||||
if (j === -1) break;
|
||||
if (str[i + 1] === '#') {
|
||||
code = parseInt((str[i + 2] === 'x' ? '0' : '') + str.substring(i + 2, j));
|
||||
if (!isNaN(code)) {
|
||||
str = str.substring(0, i) + String.fromCharCode(code) + str.substring(j + 1);
|
||||
}
|
||||
} else {
|
||||
code = str.substring(i + 1, j);
|
||||
if (html4Entities[code] || (code === 'amp' && amp)) {
|
||||
str = str.substring(0, i) + (html4Entities[code] || '&') + str.substring(j + 1);
|
||||
}
|
||||
}
|
||||
i = str.indexOf('&', i + 1);
|
||||
}
|
||||
return str;
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// cleanParamUrls
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 递归清理任意对象/数组中所有"看起来像 URL"的字符串字段:
|
||||
* - 去除反引号 / 各种空白 / 零宽字符
|
||||
* - 修复 scheme 后多余斜杠(https:////host → https://host)
|
||||
*
|
||||
* "看起来像 URL" 的判定: 含 `://`(大小写不敏感)
|
||||
* - 命中: 走清理
|
||||
* - 不命中: 原样保留(name / title / 标识符等普通字符串字段不被误伤)
|
||||
*
|
||||
* 设计: 不限定 key 列表,递归遍历,新加任何 URL 字段都自动覆盖
|
||||
*
|
||||
* @param {*} value 任意值
|
||||
* @returns {*} 与输入同结构的清理后值
|
||||
*/
|
||||
export function cleanParamUrls(value) {
|
||||
// 内部递归函数,通过闭包引用自身,避免 this 绑定问题
|
||||
const _clean = (v) => {
|
||||
if (v === null || v === undefined) return v;
|
||||
if (typeof v === 'string') {
|
||||
if (/:\/\//i.test(v)) {
|
||||
return v
|
||||
.split('').filter((ch) =>
|
||||
ch !== '`' && ch !== ' ' && ch !== '\t' && ch !== '\n' && ch !== '\r',
|
||||
).join('')
|
||||
.replace(/^(https?:\/\/)\/+/i, '$1');
|
||||
}
|
||||
return v;
|
||||
}
|
||||
if (Array.isArray(v)) {
|
||||
return v.map((item) => _clean(item));
|
||||
}
|
||||
if (typeof v === 'object') {
|
||||
const out = {};
|
||||
for (const k of Object.keys(v)) {
|
||||
out[k] = _clean(v[k]);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
return v;
|
||||
};
|
||||
return _clean(value);
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// normalizeUrl
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 严格 URL 规范化(只规范化已有部分,绝不自动补充)
|
||||
*
|
||||
* 策略:
|
||||
* 1) 预清理: 剥离反引号 / 各种空白 / BOM / 零宽字符(脏数据兜底)
|
||||
* 2) 不补 https:// — 如果原串没有协议,保持没有
|
||||
* 3) 不补 host — 如果原串没有 host,保持没有
|
||||
* 4) 只对真实存在的部分做规范化: 协议小写、host 小写、path 解析 . ..、合并多 /、去默认端口、query 排序
|
||||
* 5) scheme 后只允许恰好 2 个 '/',不允许 https:////host 这类畸形,遇到就返回 ''
|
||||
*
|
||||
* @param {string} urlString
|
||||
* @returns {string} 标准化后的 URL;若输入无法解析为合法 URL 则返回空串 ''
|
||||
*/
|
||||
export function normalizeUrl(urlString) {
|
||||
if (!urlString || typeof urlString !== 'string') return '';
|
||||
|
||||
// 1) 预清理: 反引号 / 各种空白 / BOM / 零宽字符
|
||||
let url = urlString
|
||||
.split('').filter((ch) => {
|
||||
const code = ch.charCodeAt(0);
|
||||
if (code <= 0x20) return false;
|
||||
if (ch === '`') return false;
|
||||
if (code === 0x3000) return false;
|
||||
if (code === 0xFEFF || code === 0x200B ||
|
||||
code === 0x200C || code === 0x200D ||
|
||||
code === 0x2060) return false;
|
||||
return true;
|
||||
}).join('');
|
||||
|
||||
// 2) 解析协议(可选,允许缺失)
|
||||
const protocolMatch = url.match(/^(https?):\/\//i);
|
||||
let protocol = '';
|
||||
let rest = url;
|
||||
if (protocolMatch) {
|
||||
protocol = protocolMatch[1].toLowerCase() + '://';
|
||||
rest = url.substring(protocolMatch[0].length);
|
||||
// scheme 后不能紧跟 '/',即不允许 https:////host
|
||||
if (rest.charAt(0) === '/') {
|
||||
console.warn('[normalizeUrl] scheme 后有多余的 /:', urlString);
|
||||
return '';
|
||||
}
|
||||
} else {
|
||||
rest = url;
|
||||
}
|
||||
|
||||
// 3) 解析 hash
|
||||
const hashIndex = rest.indexOf('#');
|
||||
let hash = '';
|
||||
let mainPart = rest;
|
||||
if (hashIndex !== -1) {
|
||||
hash = rest.substring(hashIndex);
|
||||
mainPart = rest.substring(0, hashIndex);
|
||||
}
|
||||
|
||||
// 4) 解析 query
|
||||
const queryIndex = mainPart.indexOf('?');
|
||||
let query = '';
|
||||
let pathPart = mainPart;
|
||||
if (queryIndex !== -1) {
|
||||
query = mainPart.substring(queryIndex); // 包含 '?'
|
||||
pathPart = mainPart.substring(0, queryIndex);
|
||||
}
|
||||
|
||||
// 5) 解析 host
|
||||
let hostname = '';
|
||||
let port = '';
|
||||
let pathname = pathPart;
|
||||
if (protocol) {
|
||||
const firstSlash = pathPart.indexOf('/');
|
||||
const hostPort = firstSlash === -1 ? pathPart : pathPart.substring(0, firstSlash);
|
||||
pathname = firstSlash === -1 ? '' : pathPart.substring(firstSlash);
|
||||
if (hostPort) {
|
||||
const colonIdx = hostPort.lastIndexOf(':');
|
||||
if (colonIdx !== -1) {
|
||||
hostname = hostPort.substring(0, colonIdx);
|
||||
port = hostPort.substring(colonIdx + 1);
|
||||
} else {
|
||||
hostname = hostPort;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 6) 规范化 host
|
||||
let lowerHostname = '';
|
||||
if (hostname) {
|
||||
lowerHostname = hostname.toLowerCase();
|
||||
if ((protocol === 'http://' && port === '80') ||
|
||||
(protocol === 'https://' && port === '443')) {
|
||||
port = '';
|
||||
}
|
||||
if (/[\/\s]/.test(lowerHostname)) {
|
||||
console.warn('[normalizeUrl] host 含非法字符:', urlString);
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
// 7) 规范化 pathname
|
||||
let normalizedPath = pathname;
|
||||
if (normalizedPath) {
|
||||
const segments = normalizedPath.split('/');
|
||||
const resolved = [];
|
||||
for (let i = 0; i < segments.length; i++) {
|
||||
const seg = segments[i];
|
||||
if (seg === '' || seg === '.') {
|
||||
if (i === 0) resolved.push('');
|
||||
continue;
|
||||
}
|
||||
if (seg === '..') {
|
||||
if (resolved.length > 1) resolved.pop();
|
||||
continue;
|
||||
}
|
||||
resolved.push(seg);
|
||||
}
|
||||
normalizedPath = resolved.join('/') || '/';
|
||||
}
|
||||
|
||||
// 8) 规范化 query
|
||||
let normalizedQuery = '';
|
||||
if (query) {
|
||||
const qs = query.substring(1);
|
||||
if (qs) {
|
||||
const pairs = qs.split('&').map((pair) => {
|
||||
const eqIdx = pair.indexOf('=');
|
||||
return eqIdx === -1
|
||||
? { k: pair, v: '' }
|
||||
: { k: pair.substring(0, eqIdx), v: pair.substring(eqIdx + 1) };
|
||||
});
|
||||
pairs.sort((a, b) => a.k.localeCompare(b.k));
|
||||
normalizedQuery = '?' + pairs.map((p) => p.k + '=' + p.v).join('&');
|
||||
}
|
||||
}
|
||||
|
||||
// 9) 拼回
|
||||
const portStr = port ? ':' + port : '';
|
||||
const hostPart = lowerHostname ? lowerHostname + portStr : '';
|
||||
const schemeAndHost = protocol + hostPart;
|
||||
return schemeAndHost + normalizedPath + normalizedQuery + hash;
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// appendQueryParams
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 给 URL 追加 query 参数(已存在的 key 会被覆盖)
|
||||
*
|
||||
* @param {string} url
|
||||
* @param {Object} params
|
||||
* @returns {string}
|
||||
*/
|
||||
export function appendQueryParams(url, params) {
|
||||
if (!url) return '';
|
||||
if (!params) return url;
|
||||
|
||||
const hashIndex = url.indexOf('#');
|
||||
let hash = '';
|
||||
let targetUrl = url;
|
||||
if (hashIndex !== -1) {
|
||||
hash = url.substring(hashIndex);
|
||||
targetUrl = url.substring(0, hashIndex);
|
||||
}
|
||||
|
||||
const separator = targetUrl.includes('?') ? '&' : '?';
|
||||
const queryString = Object.entries(params)
|
||||
.filter(([, value]) => value !== undefined && value !== null)
|
||||
// 对象/数组走 JSON.stringify,避免 String({}) 退化成 "[object Object]"
|
||||
.map(([key, value]) => `${key}=${_toParamValueString(value)}`)
|
||||
.join('&');
|
||||
|
||||
return targetUrl + separator + queryString + hash;
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// 跨平台检测 / 编码 / 跳转
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 平台检测 — 4 个目标平台:
|
||||
* - 'h5' 浏览器
|
||||
* - 'mp-weixin' 微信小程序
|
||||
* - 'mp-harmony' 鸿蒙元服务
|
||||
* - 'quickapp' 华为快应用 (实际是 H5 嵌入快应用 Webview)
|
||||
*
|
||||
* 测试覆盖: util.js 在 import 后,可在 default export 上设 __platform 强制指定
|
||||
*/
|
||||
export function getPlatform() {
|
||||
// 1) 测试覆盖: 通过模块级 _testPlatform 注入
|
||||
if (typeof globalThis !== 'undefined' && globalThis.__UTIL_NAVIGATE_TEST_PLATFORM__) {
|
||||
return globalThis.__UTIL_NAVIGATE_TEST_PLATFORM__;
|
||||
}
|
||||
|
||||
// 2) 编译时变量
|
||||
try { /* #ifdef H5 */ return 'h5'; /* #endif */ } catch (e) { /* ignore */ }
|
||||
try { /* #ifdef MP-WEIXIN */ return 'mp-weixin'; /* #endif */ } catch (e) { /* ignore */ }
|
||||
try { /* #ifdef MP-HARMONY */ return 'mp-harmony'; /* #endif */ } catch (e) { /* ignore */ }
|
||||
try { /* #ifdef MP-QUICKAPP */ return 'quickapp'; /* #endif */ } catch (e) { /* ignore */ }
|
||||
|
||||
// 3) 运行时
|
||||
if (typeof process !== 'undefined' && process.env && process.env.UNI_PLATFORM) {
|
||||
return process.env.UNI_PLATFORM;
|
||||
}
|
||||
if (typeof window !== 'undefined' && typeof window.location !== 'undefined' && typeof uni === 'undefined') {
|
||||
return 'h5';
|
||||
}
|
||||
if (typeof uni !== 'undefined' && typeof uni.getSystemInfoSync === 'function') {
|
||||
try {
|
||||
const info = uni.getSystemInfoSync();
|
||||
const p = (info && info.platform) || '';
|
||||
if (/harmony|ohos/i.test(p)) return 'mp-harmony';
|
||||
if (info.mp === true || /miniprogram/i.test(info.appName || '')) return 'mp-weixin';
|
||||
if (/quickapp|huawei/i.test(p)) return 'quickapp';
|
||||
return 'h5';
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
return 'h5';
|
||||
}
|
||||
|
||||
/**
|
||||
* 是否需要 JS 侧主动 encodeURIComponent
|
||||
* 4 平台都需要(true)
|
||||
*/
|
||||
export function shouldEncodeUrl() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* 跨平台 safeEncode(decode roundtrip + encode 一次)
|
||||
*
|
||||
* 4 平台编码行为:
|
||||
* | 平台 | 宿主 | 内部自动 encode? | JS 侧需要 encode? |
|
||||
* |-----------|---------------|------------------|------------------|
|
||||
* | h5 | 浏览器 | 否 | 必须 |
|
||||
* | mp-weixin | 微信原生 | 否 | 必须(否则微信把 & 当分隔符丢参数) |
|
||||
* | mp-harmony| 鸿蒙原生 | 否 | 必须 |
|
||||
* | quickapp | 华为快应用 Webview (本质 H5) | 否 | 必须 |
|
||||
*
|
||||
* 关键 bug 修复(2026-07-14):
|
||||
* 微信小程序下, src 内嵌 URL 含 `&` `?` `=` 空格 反引号等特殊字符时,
|
||||
* 若 JS 不主动 encode, 微信底层路由会把这些字符当成 top-level query 分隔符,
|
||||
* 导致后续 key(id/uniacid/page_params) 全部丢失。
|
||||
*
|
||||
* @param {*} v
|
||||
* @returns {string}
|
||||
*/
|
||||
export function _safeEncodeForPlatform(v) {
|
||||
const s = _toParamValueString(v);
|
||||
|
||||
// decode roundtrip: 兼容上游已 encode 过的入参
|
||||
let once = s;
|
||||
try {
|
||||
if (/%[0-9a-fA-F]{2}/.test(s)) {
|
||||
once = decodeURIComponent(s);
|
||||
}
|
||||
} catch (e) {
|
||||
once = s;
|
||||
}
|
||||
|
||||
// 4 平台都主动 encode 一次
|
||||
return encodeURIComponent(once);
|
||||
}
|
||||
|
||||
/**
|
||||
* 跨平台跳转 API 调度
|
||||
*
|
||||
* @param {Object} args
|
||||
* @param {string} args.to
|
||||
* @param {string} [args.mode='navigateTo']
|
||||
* @param {string} [args.platform] 不传则自动 getPlatform()
|
||||
* @returns {{ url: string, mode: string, api: string }}
|
||||
*/
|
||||
export function _navigateTo({ to, mode, platform } = {}) {
|
||||
const p = platform || getPlatform();
|
||||
const m = mode || 'navigateTo';
|
||||
|
||||
// H5: 用 window.location
|
||||
if (p === 'h5') {
|
||||
if (typeof window === 'undefined' || typeof window.location === 'undefined') {
|
||||
console.warn('[navigate] H5 环境下没有 window.location');
|
||||
return { url: to, mode: m, api: 'noop' };
|
||||
}
|
||||
try {
|
||||
if (m === 'reLaunch' || m === 'redirectTo') {
|
||||
window.location.replace(to);
|
||||
} else {
|
||||
window.location.href = to;
|
||||
}
|
||||
} catch (e) {
|
||||
console.warn('[navigate] H5 跳转失败:', e);
|
||||
}
|
||||
return { url: to, mode: m, api: 'window.location' };
|
||||
}
|
||||
|
||||
// 微信 / 鸿蒙 / 快应用: 走对应的 uni API
|
||||
// (华为快应用实际是 H5 嵌入快应用 Webview, uni 全局可用)
|
||||
if (typeof uni === 'undefined') {
|
||||
console.warn('[navigate] 非 H5 环境下没有 uni 全局');
|
||||
return { url: to, mode: m, api: 'noop' };
|
||||
}
|
||||
|
||||
let api = 'navigateTo';
|
||||
switch (m) {
|
||||
case 'tabbar':
|
||||
case 'switchTab':
|
||||
// 鸿蒙元服务: uni.switchTab 静默失败, 用 reLaunch 兜底
|
||||
// (微信 / 快应用: 正常用 uni.switchTab)
|
||||
if (p === 'mp-harmony') {
|
||||
uni.reLaunch({ url: to });
|
||||
api = 'reLaunch';
|
||||
} else {
|
||||
uni.switchTab({ url: to });
|
||||
api = 'switchTab';
|
||||
}
|
||||
break;
|
||||
case 'redirectTo':
|
||||
uni.redirectTo({ url: to });
|
||||
api = 'redirectTo';
|
||||
break;
|
||||
case 'reLaunch':
|
||||
uni.reLaunch({ url: to });
|
||||
api = 'reLaunch';
|
||||
break;
|
||||
case 'navigateTo':
|
||||
default:
|
||||
uni.navigateTo({ url: to });
|
||||
api = 'navigateTo';
|
||||
break;
|
||||
}
|
||||
return { url: to, mode: m, api };
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// 兼容: 把所有函数打包到一个对象(用于 util.js 挂载到 default export)
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 把所有跳转相关函数打包到一个对象, util.js 把它挂载到 default export
|
||||
* 上, 保持 this.$util.cleanParamUrls / this.$util.redirectTo 等 API 兼容
|
||||
*
|
||||
* @param {Object} [opts]
|
||||
* @param {string} [opts.platform] 强制指定平台(测试用)
|
||||
* @returns {Object}
|
||||
*/
|
||||
export function createNavigateApi(opts = {}) {
|
||||
if (opts.platform) {
|
||||
// 测试用: 注入到 globalThis,getPlatform 会优先读
|
||||
if (typeof globalThis !== 'undefined') {
|
||||
globalThis.__UTIL_NAVIGATE_TEST_PLATFORM__ = opts.platform;
|
||||
}
|
||||
}
|
||||
return {
|
||||
getPlatform,
|
||||
shouldEncodeUrl,
|
||||
_safeEncodeForPlatform,
|
||||
_navigateTo,
|
||||
cleanParamUrls,
|
||||
normalizeUrl,
|
||||
appendQueryParams,
|
||||
parsePageParams,
|
||||
resolveLinkUrl,
|
||||
decodeEntity,
|
||||
};
|
||||
}
|
||||
443
common/js/util-tabbar.js
Normal file
443
common/js/util-tabbar.js
Normal file
@@ -0,0 +1,443 @@
|
||||
/**
|
||||
* util-tabbar.js
|
||||
*
|
||||
* TabBar / 子包路径相关工具集 — 从 util.js 拆分出来
|
||||
*
|
||||
* 包含的函数(全部服务于 redirectTo / diyRedirectTo 的 tabBar 命中判断):
|
||||
* - resolvePageUrl : 根据 page_key + params 解析得到实际跳转 URL
|
||||
* - isPageInRouteList : 判断当前路由是否命中 page_routes 列表
|
||||
* - resolveLinkUrl : 解析 link 对象得到最终 URL(合并 wap_url query 进 page_params)
|
||||
* - systemTabBarList : 当前最新的 tabBar.list 配置
|
||||
* - adaptSubpackageUrl : 子包路径前缀映射(/pages/order/ → /pages_order/)
|
||||
* - _normalizePath : 归一化任意路径(私有,内部用)
|
||||
* - isTabBarRootPage : 判断给定路径是否是 TabBar 根页面
|
||||
* - isCurrentPageTabBarRoot : 判断**当前**页面是否是 TabBar 根页面(依赖 getCurrentPages/store)
|
||||
* - checkTabBarActive : 检查 tabBar 是否激活
|
||||
*
|
||||
* 设计原则:
|
||||
* 1. 不依赖 util.js,避免循环依赖
|
||||
* 2. 纯函数为主(isCurrentPageTabBarRoot 除外,它依赖 getCurrentPages 和 store,
|
||||
* 业务方在调用时手动注入 store 即可)
|
||||
* 3. PAGE_KEY_MAP / NO_TAB_PAGES / PAGE_TAB_MAP / TAB_BAR_KEYS 仍然在 util.js(业务配置)
|
||||
* util-tabbar.js 接受外部传入,提高复用性
|
||||
*/
|
||||
|
||||
import { _toParamValueString } from './util-navigate.js';
|
||||
|
||||
// =============================================================
|
||||
// PAGE_KEY → 实际 URL 解析
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 根据 page_key + params 解析得到实际跳转 URL
|
||||
* @param {string} page_key 页面语义常量, 如 PAGE_GOODS_LIST
|
||||
* @param {Object} params 页面参数(JSON 对象)
|
||||
* @param {Object} [pageKeyMap={}] page_key → 实际路径的映射表(由调用方注入,通常是 PAGE_KEY_MAP)
|
||||
* @returns {string|null} 实际 URL(已拼接参数)或 null(未匹配)
|
||||
*/
|
||||
export function resolvePageUrl(page_key, params = {}, pageKeyMap = {}) {
|
||||
if (!page_key || !pageKeyMap[page_key]) {
|
||||
return null;
|
||||
}
|
||||
let url = pageKeyMap[page_key];
|
||||
if (params && typeof params === 'object' && Object.keys(params).length > 0) {
|
||||
const parts = [];
|
||||
Object.keys(params).forEach(function (key) {
|
||||
const value = params[key];
|
||||
if (value === null || value === undefined || value === '') return;
|
||||
// 对象/数组走 JSON.stringify, 避免 String({}) 退化成 "[object Object]"
|
||||
// 消费端 resolveLinkUrl 已用 JSON.parse 还原
|
||||
const encodedValue = _toParamValueString(value);
|
||||
// H5: 浏览器不自动编码, 需要手动 encodeURIComponent
|
||||
// 小程序 / App: uni.navigateTo 会自动编码, 这里不能再 encode, 否则双重编码
|
||||
// #ifdef H5
|
||||
parts.push(key + '=' + encodeURIComponent(encodedValue));
|
||||
// #endif
|
||||
// #ifndef H5
|
||||
parts.push(key + '=' + encodedValue);
|
||||
// #endif
|
||||
});
|
||||
if (parts.length > 0) {
|
||||
url = url + (url.indexOf('?') !== -1 ? '&' : '?') + parts.join('&');
|
||||
}
|
||||
}
|
||||
return url;
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断当前路由是否命中 page_routes 列表
|
||||
* 支持 3 种写法, 可混合使用:
|
||||
* 1) PAGE_KEY_MAP 的 key → 如 "PAGE_INDEX"
|
||||
* 2) 实际页面路径 → 如 "/pages/index/index"
|
||||
* 3) 通配符路径 → 如 "/pages_tool/*" 或 "PAGE_ORDER_*"
|
||||
*
|
||||
* @param {string} currentRoute 当前页面路径(会自动补 / 前缀)
|
||||
* @param {string[]} routeList 后台配置的 page_routes 数组
|
||||
* @param {Object} [pageKeyMap={}] PAGE_KEY_MAP
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function isPageInRouteList(currentRoute, routeList, pageKeyMap = {}) {
|
||||
if (!currentRoute || !routeList || !Array.isArray(routeList) || routeList.length === 0) {
|
||||
return false;
|
||||
}
|
||||
const route = currentRoute.startsWith('/') ? currentRoute : '/' + currentRoute;
|
||||
|
||||
for (const item of routeList) {
|
||||
if (!item || typeof item !== 'string') continue;
|
||||
const entry = item.trim();
|
||||
if (!entry) continue;
|
||||
|
||||
// 1) 通配符 /pages_tool/* 或 PAGE_ORDER_*
|
||||
if (entry.endsWith('/*')) {
|
||||
const prefix = entry.slice(0, -1);
|
||||
if (route.startsWith(prefix)) return true;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (entry.endsWith('_*') && pageKeyMap) {
|
||||
const keyPrefix = entry.slice(0, -1);
|
||||
const matchedPaths = [];
|
||||
for (const k of Object.keys(pageKeyMap)) {
|
||||
if (k.startsWith(keyPrefix) && pageKeyMap[k]) {
|
||||
matchedPaths.push(pageKeyMap[k]);
|
||||
}
|
||||
}
|
||||
for (const p of matchedPaths) {
|
||||
const pn = p.startsWith('/') ? p : '/' + p;
|
||||
const dirPrefix = pn.substring(0, pn.lastIndexOf('/') + 1);
|
||||
if (route.startsWith(dirPrefix)) return true;
|
||||
if (route === pn) return true;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
// 2) PAGE_KEY 名称
|
||||
if (pageKeyMap && pageKeyMap[entry]) {
|
||||
let mapped = pageKeyMap[entry];
|
||||
mapped = mapped.startsWith('/') ? mapped : '/' + mapped;
|
||||
if (route === mapped) return true;
|
||||
continue;
|
||||
}
|
||||
|
||||
// 3) 实际路径
|
||||
if (entry.startsWith('/')) {
|
||||
if (route === entry) return true;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// resolveLinkUrl
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 解析 link 对象得到最终可跳转的 URL
|
||||
* 同时把 wap_url 自带的 query 参数与 page_params 合并, 写入 link.page_params;
|
||||
* 并把 link.wap_url 改为不含 query 的 path, 避免后续 redirectTo 重复附加
|
||||
* 优先级: page_params > wap_url query (新机制优先)
|
||||
*
|
||||
* @param {Object} link
|
||||
* @param {Object} [opts]
|
||||
* @param {Object} [opts.pageKeyMap={}] PAGE_KEY_MAP
|
||||
* @param {Function} [opts.parsePageParams] page_params 解析函数(默认用 util-navigate 的)
|
||||
* @param {Function} [opts.resolvePageUrlFn] page_key → URL 函数(默认用本文件内)
|
||||
* @param {Function} [opts.decodeEntity] HTML 实体解码函数
|
||||
* @returns {string|null}
|
||||
*/
|
||||
export function resolveLinkUrl(link, opts = {}) {
|
||||
const {
|
||||
pageKeyMap = {},
|
||||
parsePageParams = null,
|
||||
resolvePageUrlFn = null,
|
||||
decodeEntity = null,
|
||||
} = opts;
|
||||
|
||||
if (!link) return null;
|
||||
|
||||
// 0. 把 wap_url 中的 query 合并到 page_params
|
||||
if (link.wap_url) {
|
||||
const _decode = decodeEntity || ((s) => s);
|
||||
const decodedWap = _decode(link.wap_url);
|
||||
const queryIdx = decodedWap.indexOf('?');
|
||||
if (queryIdx !== -1) {
|
||||
const path = decodedWap.substring(0, queryIdx);
|
||||
const queryStr = decodedWap.substring(queryIdx + 1);
|
||||
const urlParams = {};
|
||||
queryStr.split('&').forEach((kv) => {
|
||||
if (!kv) return;
|
||||
const eqIdx = kv.indexOf('=');
|
||||
const k = eqIdx === -1 ? kv : kv.substring(0, eqIdx);
|
||||
const v = eqIdx === -1 ? '' : kv.substring(eqIdx + 1);
|
||||
if (k) urlParams[k] = v;
|
||||
});
|
||||
// 解析 page_params (可能是字符串或对象) — 走统一 helper
|
||||
const _parse = parsePageParams || ((p) => (p && typeof p === 'object') ? p : {});
|
||||
const pageParams = _parse(link.page_params);
|
||||
// 合并: page_params 覆盖 urlParams (新机制优先)
|
||||
link.page_params = Object.assign({}, urlParams, pageParams);
|
||||
// 把 link.wap_url 改为不含 query 的 path
|
||||
link.wap_url = path;
|
||||
}
|
||||
}
|
||||
// 1. 优先使用 page_key(新机制)
|
||||
if (link.page_key) {
|
||||
const _parse = parsePageParams || ((p) => (p && typeof p === 'object') ? p : {});
|
||||
const _resolvePageUrl = resolvePageUrlFn || ((key, params) => resolvePageUrl(key, params, pageKeyMap));
|
||||
const params = _parse(link.page_params);
|
||||
const url = _resolvePageUrl(link.page_key, params);
|
||||
if (url) return url;
|
||||
}
|
||||
// 2. 回退: 旧的 wap_url(已被处理为不含 query 的 path)
|
||||
if (link.wap_url) {
|
||||
return link.wap_url;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// TabBar 列表与适配
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 当前最新的 tabBar.list
|
||||
* 注意: 该函数需要业务方传入 4 个常量(INDEX/CATEGORY/CONTACT/MEMBER)
|
||||
* 通常由 util.js 在 import 后调用 _setSystemTabBarList 注入
|
||||
*/
|
||||
export function makeSystemTabBarList(indexUrl, categoryUrl, contactUrl, memberUrl) {
|
||||
return [indexUrl, categoryUrl, contactUrl, memberUrl];
|
||||
}
|
||||
|
||||
/**
|
||||
* 适配子包路径
|
||||
* 把老路径 /pages/xxx/ 映射到新路径 /pages_xxx/
|
||||
*
|
||||
* @param {string} url
|
||||
* @returns {string}
|
||||
*/
|
||||
export function adaptSubpackageUrl(url) {
|
||||
if (!url) return url;
|
||||
// 定义前缀映射表(key=旧前缀, value=新分包前缀)
|
||||
const urlPrefixMap = {
|
||||
'/pages/promotion/': '/pages_promotion/',
|
||||
'/pages/order/': '/pages_order/',
|
||||
'/pages/goods/': '/pages_goods/',
|
||||
'/pages/member/': '/pages_tool/member/',
|
||||
'/pages/login/': '/pages_tool/login/',
|
||||
'/pages/agreement/': '/pages_tool/agreement/',
|
||||
'/pages/article/': '/pages_tool/article/',
|
||||
'/pages/cases/': '/pages_tool/cases/',
|
||||
'/pages/contact/': '/pages_tool/contact/',
|
||||
'/pages/files/': '/pages_tool/files/',
|
||||
'/pages/form/': '/pages_tool/form/',
|
||||
'/pages/help/': '/pages_tool/help/',
|
||||
'/pages/notice/': '/pages_tool/notice/',
|
||||
'/pages/pay/': '/pages_tool/pay/',
|
||||
'/pages/recharge/': '/pages_tool/recharge/',
|
||||
'/pages/seal/': '/pages_tool/seal/',
|
||||
'/pages/storeclose/': '/pages_tool/storeclose/',
|
||||
'/pages/vr/': '/pages_tool/vr/',
|
||||
'/pages/weapp/': '/pages_tool/weapp/',
|
||||
'/pages/webview/': '/pages_tool/webview/',
|
||||
};
|
||||
|
||||
const prefixes = Object.keys(urlPrefixMap);
|
||||
if (prefixes.length === 0) return url;
|
||||
|
||||
const regex = new RegExp(
|
||||
'^(' + prefixes.map((key) =>
|
||||
key.replace(/\//g, '\\/').replace(/\*/g, '.*'),
|
||||
).join('|') + ')',
|
||||
);
|
||||
|
||||
function replacePrefix(str) {
|
||||
return str.replace(regex, (match) => {
|
||||
const newPrefix = urlPrefixMap[match];
|
||||
return newPrefix || match;
|
||||
});
|
||||
}
|
||||
|
||||
// 兜底: 把 3 个及以上的连续 `/` 收敛为 2 个, 只动 path 部分
|
||||
const collapsed = url.replace(/([^:])\/{3,}/g, '$1//');
|
||||
return replacePrefix(collapsed);
|
||||
}
|
||||
|
||||
// =============================================================
|
||||
// TabBar 命中判断(私有辅助)
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 归一化任意路径: 确保以 '/' 开头, 去除 query, 适配子包
|
||||
* (私有, 仅本模块内部使用)
|
||||
*/
|
||||
function _normalizePath(path) {
|
||||
if (!path) return '';
|
||||
const normalized = path.startsWith('/') ? path : '/' + path;
|
||||
return adaptSubpackageUrl(normalized).split('?')[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* 从归一化路径提取分包名(parts[1])
|
||||
* (私有, 仅本模块内部使用)
|
||||
*/
|
||||
function _getPackageName(normalizedPath) {
|
||||
const parts = normalizedPath.split('/');
|
||||
return parts[1] || '';
|
||||
}
|
||||
|
||||
/**
|
||||
* 给定当前页面路径 + tab 配置, 返回当前页面所属的 tab URL
|
||||
* 优先级: 精确匹配 > packageEntryTab > 分包名回退匹配
|
||||
* (私有)
|
||||
*/
|
||||
function _findMatchingTabUrl(currentPagePath, tabBarList, packageEntryTab) {
|
||||
if (!tabBarList || !tabBarList.list || !Array.isArray(tabBarList.list)) return null;
|
||||
|
||||
const tabUrls = tabBarList.list
|
||||
.filter((item) => item.link && item.link.wap_url)
|
||||
.map((item) => _normalizePath(item.link.wap_url));
|
||||
|
||||
const normalizedCurrent = _normalizePath(currentPagePath);
|
||||
|
||||
// 1) 精确匹配 → 当前页面就是 tab 页面
|
||||
const exactMatch = tabUrls.find((url) => url === normalizedCurrent);
|
||||
if (exactMatch) return exactMatch;
|
||||
|
||||
// 2) 通过 packageEntryTab(由 updateCurrentRoute/redirectTo 写入)
|
||||
const packageName = _getPackageName(normalizedCurrent);
|
||||
if (packageEntryTab && typeof packageEntryTab === 'object' && packageEntryTab[packageName]) {
|
||||
const entryTab = packageEntryTab[packageName];
|
||||
const normalizedEntry = _normalizePath(entryTab);
|
||||
if (tabUrls.includes(normalizedEntry)) return normalizedEntry;
|
||||
}
|
||||
|
||||
// 3) 回退: 同分包内的第一个 tab(基于分包名匹配)
|
||||
return tabUrls.find((url) => _getPackageName(url) === packageName) || null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断给定路径是否是 TabBar 根页面(与 diy_bottom_nav 中任意一项精确相等)
|
||||
*
|
||||
* @param {string} pagePath 当前页面路径(可以带/不带前导斜杠、可以带 query)
|
||||
* @param {Object|null} tabBarList tabBar 配置对象($store.state.tabBarList)
|
||||
* @returns {boolean} 如果是 TabBar 根页面返回 true
|
||||
*/
|
||||
export function isTabBarRootPage(pagePath, tabBarList) {
|
||||
if (!pagePath) return false;
|
||||
if (!tabBarList || !tabBarList.list || !Array.isArray(tabBarList.list)) return false;
|
||||
const normalizedCurrent = _normalizePath(pagePath);
|
||||
if (!normalizedCurrent) return false;
|
||||
return tabBarList.list.some((item) => {
|
||||
if (!item || !item.link || !item.link.wap_url) return false;
|
||||
const normalizedTab = _normalizePath(item.link.wap_url);
|
||||
return normalizedTab === normalizedCurrent;
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断**当前**页面是否是 TabBar 根页面
|
||||
* 封装了 getCurrentPages() + isTabBarRootPage 的组合, 供业务组件在弹窗/操作前判断
|
||||
*
|
||||
* 调用方需要注入 getCurrentPages 和 store:
|
||||
* isCurrentPageTabBarRoot({
|
||||
* getCurrentPages: typeof getCurrentPages === 'function' ? getCurrentPages : null,
|
||||
* store,
|
||||
* tabBarList: null, // 不传则从 store.state.tabBarList 取
|
||||
* })
|
||||
*
|
||||
* @param {Object} [opts={}]
|
||||
* @param {Function} [opts.getCurrentPages]
|
||||
* @param {Object} [opts.store]
|
||||
* @param {Object} [opts.tabBarList]
|
||||
* @returns {boolean}
|
||||
*/
|
||||
export function isCurrentPageTabBarRoot(opts = {}) {
|
||||
try {
|
||||
const gcp = opts.getCurrentPages || (typeof getCurrentPages === 'function' ? getCurrentPages : null);
|
||||
if (!gcp) return false;
|
||||
const pages = gcp();
|
||||
if (!pages || !pages.length) return false;
|
||||
const currentRoute = '/' + String(pages[pages.length - 1].route || '').replace(/^\//, '');
|
||||
if (!currentRoute) return false;
|
||||
const tabBarList = opts.tabBarList
|
||||
|| (opts.store && opts.store.state ? opts.store.state.tabBarList : null);
|
||||
return isTabBarRootPage(currentRoute, tabBarList);
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查 tabBar 是否激活
|
||||
*
|
||||
* @param {string} linkUrl 链接路径 /pages/goods/category
|
||||
* @param {string} currentPageRoute 当前页面路径 /pages_goods/category
|
||||
* @param {Object} tabBarList tabBar 配置对象, 用于动态判断
|
||||
* @param {Object} packageEntryTab 追踪每个分包的入口 Tab { 'pages_goods': '/pages_goods/category' }
|
||||
* @param {Object} [currentPageQuery={}] 当前页面 query 参数, 用于读取 from_tab 来源记忆
|
||||
* @param {Object} [opts={}]
|
||||
* @param {Set} [opts.noTabPages] 独立流程页集合(NO_TAB_PAGES)
|
||||
* @param {Object} [opts.pageTabMap] 页面级 Tab 精确绑定表(PAGE_TAB_MAP)
|
||||
* @returns {boolean} 是否激活
|
||||
*/
|
||||
export function checkTabBarActive(
|
||||
linkUrl,
|
||||
currentPageRoute,
|
||||
tabBarList,
|
||||
packageEntryTab,
|
||||
currentPageQuery = {},
|
||||
opts = {},
|
||||
) {
|
||||
const { noTabPages = null, pageTabMap = {} } = opts;
|
||||
|
||||
// 1) 归一化 linkUrl: 统一前导 '/' + 子包路径适配 + 去除 query
|
||||
const normalizedLink = _normalizePath(linkUrl);
|
||||
const normalizedCurrent = _normalizePath(currentPageRoute);
|
||||
|
||||
if (!normalizedLink) return false;
|
||||
|
||||
// 2) 精确匹配: 当前页面就是 linkUrl 指向的页面
|
||||
if (normalizedLink === normalizedCurrent) return true;
|
||||
|
||||
// 3) 独立流程页: 不点亮任何 Tab
|
||||
if (noTabPages && noTabPages.has && noTabPages.has(normalizedCurrent)) return false;
|
||||
|
||||
// 4) 若传入 tabBarList, 使用动态判断逻辑
|
||||
if (tabBarList && tabBarList.list && Array.isArray(tabBarList.list)) {
|
||||
const tabUrls = tabBarList.list
|
||||
.filter((item) => item.link && item.link.wap_url)
|
||||
.map((item) => _normalizePath(item.link.wap_url));
|
||||
|
||||
// 检查当前 linkUrl 是否是合法的 tab URL
|
||||
if (!tabUrls.includes(normalizedLink)) return false;
|
||||
|
||||
// 5) 页面级 Tab 精确绑定
|
||||
const mappedTabUrl = pageTabMap[normalizedCurrent];
|
||||
if (mappedTabUrl) {
|
||||
return normalizedLink === _normalizePath(mappedTabUrl);
|
||||
}
|
||||
if (mappedTabUrl === null) return false;
|
||||
|
||||
// 6) 来源记忆兜底: 从哪个 Tab 跳转过来, 就保持那个 Tab 高亮
|
||||
const fromTab = currentPageQuery.from_tab;
|
||||
if (fromTab) {
|
||||
const normalizedFromTab = _normalizePath(fromTab);
|
||||
if (tabUrls.includes(normalizedFromTab)) {
|
||||
return normalizedLink === normalizedFromTab;
|
||||
}
|
||||
}
|
||||
|
||||
// 7) 分包入口追踪: 通过 updateCurrentRoute 写入的入口 tab
|
||||
const matchingTabUrl = _findMatchingTabUrl(currentPageRoute, tabBarList, packageEntryTab);
|
||||
if (matchingTabUrl) return normalizedLink === matchingTabUrl;
|
||||
|
||||
// 8) 同分包回退: linkUrl 和当前页面在同一分包 → 高亮
|
||||
const linkPackage = _getPackageName(normalizedLink);
|
||||
const currentPackage = _getPackageName(normalizedCurrent);
|
||||
return linkPackage && currentPackage && linkPackage === currentPackage;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
@@ -8,62 +8,47 @@ import {
|
||||
} from 'common/js/wx-jssdk.js';
|
||||
import { copyText } from './uniapp.utils.js';
|
||||
|
||||
//
|
||||
export function decodeEntity(str, amp) {
|
||||
const html4Entities = {
|
||||
nbsp: ' ', iexcl: '¡', cent: '¢', pound: '£', curren: '₣', yen: '¥', brvbar: '§', sect: 'Ş', uml: '¨', copy: '©', ordf: 'ª', laquo: '«', not: '¬', shy: '®', macr: '¯', deg: '°', plusmn: '±', sup2: '²', sup3: '³', acute: '´', micro: 'µ', para: '¶', middot: '·', cedil: '¸', sup1: '¹', ordm: 'º', raquo: '»', frac14: '¼', frac12: '½', frac34: '¾', iquest: '¿', agrave: 'à', aacute: 'á', acirc: 'â', atilde: 'ã', auml: 'ä', aring: 'å', aelig: 'æ', ccedil: 'ç', egrave: 'è', eacute: 'é', ecirc: 'ê', euml: 'ë', igrave: 'ì', iacute: 'í', icirc: 'î', iuml: 'ï', eth: 'ð', ntilde: 'ñ', ograve: 'ò', oacute: 'ó', ocirc: 'ô', otilde: 'õ', ouml: 'ö', times: 'ø', ugrave: 'ù', uacute: 'ú', ucirc: 'û', uuml: 'ü', yacute: 'ý', thorn: 'þ', yuml: 'ÿ', fnof: 'ƒ', alpha: 'α', beta: 'β', gamma: 'γ', delta: 'δ', epsilon: 'ε', zeta: 'ζ', eta: 'η', theta: 'θ', iota: 'ι', kappa: 'κ', lambda: 'λ', mu: 'μ', nu: 'ν', xi: 'ξ', omicron: 'ο', pi: 'π', rho: 'ρ', sigmaf: 'σ', sigma: 'σ', tau: 'τ', upsilon: 'υ', phi: 'φ', chi: 'ψ', omega: 'ω'
|
||||
}
|
||||
amp = amp === undefined ? true : amp
|
||||
let i = str.indexOf('&')
|
||||
while (i !== -1) {
|
||||
const j = str.indexOf(';', i + 3)
|
||||
let code
|
||||
if (j === -1) break
|
||||
if (str[i + 1] === '#') {
|
||||
code = parseInt((str[i + 2] === 'x' ? '0' : '') + str.substring(i + 2, j))
|
||||
if (!isNaN(code)) {
|
||||
str = str.substring(0, i) + String.fromCharCode(code) + str.substring(j + 1)
|
||||
}
|
||||
} else {
|
||||
code = str.substring(i + 1, j)
|
||||
if (html4Entities[code] || (code === 'amp' && amp)) {
|
||||
str = str.substring(0, i) + (html4Entities[code] || '&') + str.substring(j + 1)
|
||||
}
|
||||
}
|
||||
i = str.indexOf('&', i + 1)
|
||||
}
|
||||
return str
|
||||
}
|
||||
// 跳转相关工具集(纯函数, 不依赖 util.js 自身, 避免循环依赖)
|
||||
import {
|
||||
_toParamValueString,
|
||||
parsePageParams as _parsePageParams,
|
||||
decodeEntity,
|
||||
cleanParamUrls,
|
||||
normalizeUrl as _normalizeUrlBase,
|
||||
appendQueryParams as _appendQueryParamsBase,
|
||||
_shouldEncodeUrl,
|
||||
_safeEncodeForPlatform,
|
||||
_navigateTo,
|
||||
} from './util-navigate.js';
|
||||
|
||||
// TabBar / 子包路径相关工具集(纯函数, 依赖 util-navigate 的 _toParamValueString)
|
||||
import {
|
||||
resolvePageUrl as _resolvePageUrl,
|
||||
isPageInRouteList as isPageInRouteListFn,
|
||||
resolveLinkUrl as _resolveLinkUrlPure,
|
||||
systemTabBarList as _makeSystemTabBarList,
|
||||
adaptSubpackageUrl,
|
||||
isTabBarRootPage as _isTabBarRootPagePure,
|
||||
isCurrentPageTabBarRoot as _isCurrentPageTabBarRootPure,
|
||||
checkTabBarActive as _checkTabBarActivePure,
|
||||
} from './util-tabbar.js';
|
||||
|
||||
|
||||
/**
|
||||
* 把任意值序列化成可作为 URL 参数的字符串。
|
||||
* - null / undefined → '' （由调用方负责过滤空值）
|
||||
* - 对象 / 数组 → JSON.stringify （避免 String({}) 退化成 "[object Object]"）
|
||||
* - 其它类型（number / boolean / string）→ String(v)，保持原行为
|
||||
*
|
||||
* 与消费端约定：page_params 一律以 JSON 字符串形式落 URL，
|
||||
* 消费侧用 parsePageParams 还原为对象。
|
||||
*
|
||||
* @example
|
||||
* _toParamValueString({a:1}) // '{"a":1}'
|
||||
* _toParamValueString('hello') // 'hello'
|
||||
* _toParamValueString(null) // ''
|
||||
* _toParamValueString([1, 2]) // '[1,2]'
|
||||
*
|
||||
* @param {*} v
|
||||
* @returns {string}
|
||||
*/
|
||||
function _toParamValueString(v) {
|
||||
if (v === null || v === undefined) return ''
|
||||
if (typeof v === 'object') return JSON.stringify(v)
|
||||
return String(v)
|
||||
}
|
||||
// =============================================================
|
||||
// HTML 实体解码 / 参数序列化 / page_params 解析
|
||||
// (直接 re-export util-navigate 的同名函数, 保持 API 兼容)
|
||||
// =============================================================
|
||||
|
||||
export { decodeEntity, cleanParamUrls, _toParamValueString };
|
||||
|
||||
/**
|
||||
* 把 URL 上的 page_params 还原成对象。是 _toParamValueString 的逆操作。
|
||||
* 容错策略：任何解析失败都安全降级到 defaultValue，不抛异常。
|
||||
*
|
||||
* 注意: 与 util-navigate.js 的 parsePageParams 略有差异 —— 本版本对空串 '' 也返回 defaultValue,
|
||||
* 保持原 util.js 的旧行为(老代码 `'page_params' in link` 但 page_params === '' 时,
|
||||
* 旧版会落到 defaultValue, 新版会落到 defaultValue 同样的结果)。
|
||||
*
|
||||
* @example
|
||||
* parsePageParams('{"a":1}') // { a: 1 }
|
||||
* parsePageParams({a: 1}) // { a: 1 } (已是对象直接返回)
|
||||
@@ -78,12 +63,7 @@ function _toParamValueString(v) {
|
||||
* @returns {Object}
|
||||
*/
|
||||
export function parsePageParams(raw, defaultValue = {}) {
|
||||
if (raw == null || raw === '') return defaultValue
|
||||
if (typeof raw === 'object') return raw
|
||||
if (typeof raw === 'string') {
|
||||
try { return JSON.parse(raw) } catch (e) { return defaultValue }
|
||||
}
|
||||
return defaultValue
|
||||
return _parsePageParams(raw, defaultValue);
|
||||
}
|
||||
|
||||
|
||||
@@ -318,6 +298,12 @@ export const PAGE_TAB_MAP = {
|
||||
'/pages_tool/files/list': null
|
||||
};
|
||||
|
||||
|
||||
// =============================================================
|
||||
// 基于 util-tabbar / util-navigate 的本文件 wrapper
|
||||
// (这些函数都依赖本文件导出的 PAGE_KEY_MAP, 所以要包一层)
|
||||
// =============================================================
|
||||
|
||||
/**
|
||||
* 根据 page_key + params 解析得到实际跳转URL
|
||||
* @param {string} page_key 页面语义常量，如 PAGE_GOODS_LIST
|
||||
@@ -325,32 +311,7 @@ export const PAGE_TAB_MAP = {
|
||||
* @returns {string|null} 实际URL（已拼接参数）或 null（未匹配）
|
||||
*/
|
||||
export const resolvePageUrl = (page_key, params = {}) => {
|
||||
if (!page_key || !PAGE_KEY_MAP[page_key]) {
|
||||
return null;
|
||||
}
|
||||
let url = PAGE_KEY_MAP[page_key];
|
||||
if (params && typeof params === 'object' && Object.keys(params).length > 0) {
|
||||
const parts = [];
|
||||
Object.keys(params).forEach(function (key) {
|
||||
const value = params[key];
|
||||
if (value === null || value === undefined || value === '') return;
|
||||
// 对象/数组走 JSON.stringify,避免 String({}) 退化成 "[object Object]"
|
||||
// 消费端 resolveLinkUrl 已用 JSON.parse 还原
|
||||
const encodedValue = _toParamValueString(value);
|
||||
// H5:浏览器不自动编码,需要手动 encodeURIComponent
|
||||
// 小程序/App:uni.navigateTo 会自动编码,这里不能再 encode,否则双重编码
|
||||
// #ifdef H5
|
||||
parts.push(key + '=' + encodeURIComponent(encodedValue));
|
||||
// #endif
|
||||
// #ifndef H5
|
||||
parts.push(key + '=' + encodedValue);
|
||||
// #endif
|
||||
});
|
||||
if (parts.length > 0) {
|
||||
url = url + (url.indexOf('?') !== -1 ? '&' : '?') + parts.join('&');
|
||||
}
|
||||
}
|
||||
return url;
|
||||
return _resolvePageUrl(page_key, params, PAGE_KEY_MAP);
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -364,53 +325,7 @@ export const resolvePageUrl = (page_key, params = {}) => {
|
||||
* @returns {boolean} 是否命中
|
||||
*/
|
||||
export const isPageInRouteList = (currentRoute, routeList) => {
|
||||
if (!currentRoute || !routeList || !Array.isArray(routeList) || routeList.length === 0) {
|
||||
return false;
|
||||
}
|
||||
const route = currentRoute.startsWith('/') ? currentRoute : '/' + currentRoute;
|
||||
|
||||
for (const item of routeList) {
|
||||
if (!item || typeof item !== 'string') continue;
|
||||
const entry = item.trim();
|
||||
if (!entry) continue;
|
||||
|
||||
if (entry.endsWith('/*')) {
|
||||
const prefix = entry.slice(0, -1);
|
||||
if (route.startsWith(prefix)) return true;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (entry.endsWith('_*') && PAGE_KEY_MAP) {
|
||||
const keyPrefix = entry.slice(0, -1);
|
||||
const matchedPaths = [];
|
||||
for (const k of Object.keys(PAGE_KEY_MAP)) {
|
||||
if (k.startsWith(keyPrefix) && PAGE_KEY_MAP[k]) {
|
||||
matchedPaths.push(PAGE_KEY_MAP[k]);
|
||||
}
|
||||
}
|
||||
for (const p of matchedPaths) {
|
||||
const pn = p.startsWith('/') ? p : '/' + p;
|
||||
const dirPrefix = pn.substring(0, pn.lastIndexOf('/') + 1);
|
||||
if (route.startsWith(dirPrefix)) return true;
|
||||
if (route === pn) return true;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
if (PAGE_KEY_MAP && PAGE_KEY_MAP[entry]) {
|
||||
let mapped = PAGE_KEY_MAP[entry];
|
||||
mapped = mapped.startsWith('/') ? mapped : '/' + mapped;
|
||||
if (route === mapped) return true;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (entry.startsWith('/')) {
|
||||
if (route === entry) return true;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
return isPageInRouteListFn(currentRoute, routeList, PAGE_KEY_MAP);
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -418,157 +333,35 @@ export const isPageInRouteList = (currentRoute, routeList) => {
|
||||
* 同时把 wap_url 自带的 query 参数与 page_params 合并, 写入 link.page_params;
|
||||
* 并把 link.wap_url 改为不含 query 的 path, 避免后续 redirectTo 重复附加
|
||||
* 优先级: page_params > wap_url query (新机制优先)
|
||||
*
|
||||
* @param {Object} link
|
||||
* @returns {string|null}
|
||||
*/
|
||||
export const resolveLinkUrl = (link) => {
|
||||
if (!link) return null;
|
||||
// 0. 把 wap_url 中的 query 合并到 page_params
|
||||
// - 拆分 wap_url 的 query, 与 link.page_params 合并
|
||||
// - page_params 优先 (新机制, 显式声明的参数覆盖 wap_url query)
|
||||
// - 把 link.wap_url 改为不含 query 的 path, 避免后续 redirectTo 二次编码
|
||||
if (link.wap_url) {
|
||||
const decodedWap = decodeEntity(link.wap_url);
|
||||
const queryIdx = decodedWap.indexOf('?');
|
||||
if (queryIdx !== -1) {
|
||||
const path = decodedWap.substring(0, queryIdx);
|
||||
const queryStr = decodedWap.substring(queryIdx + 1);
|
||||
const urlParams = {};
|
||||
queryStr.split('&').forEach(kv => {
|
||||
if (!kv) return;
|
||||
const eqIdx = kv.indexOf('=');
|
||||
const k = eqIdx === -1 ? kv : kv.substring(0, eqIdx);
|
||||
const v = eqIdx === -1 ? '' : kv.substring(eqIdx + 1);
|
||||
if (k) urlParams[k] = v;
|
||||
});
|
||||
// 解析 page_params (可能是字符串或对象) — 走统一 helper,避免分散 try/catch
|
||||
const pageParams = parsePageParams(link.page_params);
|
||||
// 合并: page_params 覆盖 urlParams (新机制优先)
|
||||
link.page_params = Object.assign({}, urlParams, pageParams);
|
||||
// 把 link.wap_url 改为不含 query 的 path
|
||||
link.wap_url = path;
|
||||
}
|
||||
}
|
||||
// 1. 优先使用 page_key（新机制）
|
||||
// 0. 先走 util-tabbar 的纯函数(合并 wap_url 的 query 到 page_params)
|
||||
const after = _resolveLinkUrlPure(link, {
|
||||
pageKeyMap: PAGE_KEY_MAP,
|
||||
parsePageParams: parsePageParams,
|
||||
decodeEntity: decodeEntity,
|
||||
});
|
||||
// 1. 优先使用 page_key(新机制)
|
||||
if (link.page_key) {
|
||||
const params = parsePageParams(link.page_params);
|
||||
const url = resolvePageUrl(link.page_key, params);
|
||||
if (url) return url;
|
||||
}
|
||||
// 2. 回退：旧的 wap_url（已被处理为不含 query 的 path）
|
||||
if (link.wap_url) {
|
||||
return link.wap_url;
|
||||
}
|
||||
return null;
|
||||
// 2. 回退: 旧 wap_url / 外部 http 链接
|
||||
return after;
|
||||
};
|
||||
|
||||
// 当前最新的tabBar.list (参见pages.json 中的tabBar.list 配置)
|
||||
export const systemTabBarList = [
|
||||
// 当前最新的 tabBar.list (由 util-tabbar 的 makeSystemTabBarList 生成)
|
||||
export const systemTabBarList = _makeSystemTabBarList(
|
||||
INDEX_PAGE_URL,
|
||||
CATEGORY_PAGE_URL,
|
||||
CONTACT_PAGE_URL,
|
||||
MEMBER_PAGE_URL
|
||||
];
|
||||
|
||||
/**
|
||||
* 适配子包路径
|
||||
* @param {string} url
|
||||
* @returns
|
||||
*/
|
||||
export const adaptSubpackageUrl = (url) => {
|
||||
/**
|
||||
* 特别注意:
|
||||
* 由于老版本或者后台系统服务未同步更新可以作为tabBarList的最新分包路径。历史遗留问题，需要与当前最新分包机制版本保持一致。
|
||||
* 系统当前的支持tarbarList（包含动态tabBar）,注意这是实际分包后的路径
|
||||
* 根据匹配映射关系，修改url为实际分包后的路径
|
||||
*/
|
||||
// 定义前缀映射表（key=旧前缀, value=新分包前缀）
|
||||
const urlPrefixMap = {
|
||||
'/pages/promotion/': '/pages_promotion/',
|
||||
'/pages/order/': '/pages_order/',
|
||||
'/pages/goods/': '/pages_goods/',
|
||||
'/pages/member/': '/pages_tool/member/',
|
||||
'/pages/login/': '/pages_tool/login/',
|
||||
'/pages/agreement/': '/pages_tool/agreement/',
|
||||
'/pages/article/': '/pages_tool/article/',
|
||||
'/pages/cases/': '/pages_tool/cases/',
|
||||
'/pages/contact/': '/pages_tool/contact/',
|
||||
'/pages/files/': '/pages_tool/files/',
|
||||
'/pages/form/': '/pages_tool/form/',
|
||||
'/pages/help/': '/pages_tool/help/',
|
||||
'/pages/notice/': '/pages_tool/notice/',
|
||||
'/pages/pay/': '/pages_tool/pay/',
|
||||
'/pages/recharge/': '/pages_tool/recharge/',
|
||||
'/pages/seal/': '/pages_tool/seal/',
|
||||
'/pages/storeclose/': '/pages_tool/storeclose/',
|
||||
'/pages/vr/': '/pages_tool/vr/',
|
||||
'/pages/weapp/': '/pages_tool/weapp/',
|
||||
'/pages/webview/': '/pages_tool/webview/',
|
||||
};
|
||||
|
||||
// 构建正则表达式（加 ^ 锚定前缀，避免路径中间出现 /pages/xxx/ 时误匹配）
|
||||
const prefixes = Object.keys(urlPrefixMap);
|
||||
if (prefixes.length === 0) return url;
|
||||
|
||||
const regex = new RegExp(
|
||||
'^(' + prefixes.map(key =>
|
||||
key.replace(/\//g, '\\/').replace(/\*/g, '.*')
|
||||
).join('|') + ')'
|
||||
);
|
||||
|
||||
// 替换函数
|
||||
function replacePrefix(str) {
|
||||
return str.replace(regex, match => {
|
||||
const newPrefix = urlPrefixMap[match];
|
||||
return newPrefix || match;
|
||||
});
|
||||
}
|
||||
|
||||
// 兜底:把 3 个及以上的连续 `/` 收敛为 2 个,只动 path 部分(避免影响 `https://` 这种 scheme)
|
||||
// 例如把 `/pages//webview///webview?x=1` 修正成 `/pages//webview//webview?x=1`
|
||||
const collapsed = url.replace(/([^:])\/{3,}/g, '$1//');
|
||||
return replacePrefix(collapsed);
|
||||
}
|
||||
|
||||
// 归一化任意路径：确保以 '/' 开头，去除 query，适配子包
|
||||
function _normalizePath(path) {
|
||||
if (!path) return '';
|
||||
const normalized = path.startsWith('/') ? path : '/' + path;
|
||||
return adaptSubpackageUrl(normalized).split('?')[0];
|
||||
}
|
||||
|
||||
// 从归一化路径提取分包名（parts[1]）
|
||||
function _getPackageName(normalizedPath) {
|
||||
const parts = normalizedPath.split('/');
|
||||
return parts[1] || '';
|
||||
}
|
||||
|
||||
// 给定当前页面路径 + tab 配置，返回当前页面所属的 tab URL
|
||||
// 优先级：精确匹配 > packageEntryTab > 分包名回退匹配
|
||||
function _findMatchingTabUrl(currentPagePath, tabBarList, packageEntryTab) {
|
||||
if (!tabBarList || !tabBarList.list || !Array.isArray(tabBarList.list)) return null;
|
||||
|
||||
const tabUrls = tabBarList.list
|
||||
.filter(item => item.link && item.link.wap_url)
|
||||
.map(item => _normalizePath(item.link.wap_url));
|
||||
|
||||
const normalizedCurrent = _normalizePath(currentPagePath);
|
||||
|
||||
// 1) 精确匹配 → 当前页面就是 tab 页面
|
||||
const exactMatch = tabUrls.find(url => url === normalizedCurrent);
|
||||
if (exactMatch) return exactMatch;
|
||||
|
||||
// 2) 通过 packageEntryTab（由 updateCurrentRoute/redirectTo 写入）
|
||||
const packageName = _getPackageName(normalizedCurrent);
|
||||
if (packageEntryTab && typeof packageEntryTab === 'object' && packageEntryTab[packageName]) {
|
||||
const entryTab = packageEntryTab[packageName];
|
||||
const normalizedEntry = _normalizePath(entryTab);
|
||||
if (tabUrls.includes(normalizedEntry)) return normalizedEntry;
|
||||
}
|
||||
|
||||
// 3) 回退：同分包内的第一个 tab（基于分包名匹配）
|
||||
return tabUrls.find(url => _getPackageName(url) === packageName) || null;
|
||||
}
|
||||
MEMBER_PAGE_URL,
|
||||
);
|
||||
|
||||
/**
|
||||
* 判断给定路径是否是 TabBar 根页面（与 diy_bottom_nav 中任意一项精确相等）
|
||||
@@ -577,15 +370,7 @@ function _findMatchingTabUrl(currentPagePath, tabBarList, packageEntryTab) {
|
||||
* @returns {boolean} 如果是 TabBar 根页面返回 true；路径无效/未配置 tabBarList 时返回 false
|
||||
*/
|
||||
export const isTabBarRootPage = (pagePath, tabBarList) => {
|
||||
if (!pagePath) return false;
|
||||
if (!tabBarList || !tabBarList.list || !Array.isArray(tabBarList.list)) return false;
|
||||
const normalizedCurrent = _normalizePath(pagePath);
|
||||
if (!normalizedCurrent) return false;
|
||||
return tabBarList.list.some(item => {
|
||||
if (!item || !item.link || !item.link.wap_url) return false;
|
||||
const normalizedTab = _normalizePath(item.link.wap_url);
|
||||
return normalizedTab === normalizedCurrent;
|
||||
});
|
||||
return _isTabBarRootPagePure(pagePath, tabBarList);
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -595,16 +380,7 @@ export const isTabBarRootPage = (pagePath, tabBarList) => {
|
||||
* @returns {boolean} 当前页是 TabBar 项时返回 true,否则 false(getCurrentPages 不可用时也返回 false)
|
||||
*/
|
||||
export const isCurrentPageTabBarRoot = () => {
|
||||
try {
|
||||
const pages = typeof getCurrentPages === 'function' ? getCurrentPages() : []
|
||||
if (!pages || !pages.length) return false
|
||||
const currentRoute = '/' + String(pages[pages.length - 1].route || '').replace(/^\//, '')
|
||||
if (!currentRoute) return false
|
||||
const tabBarList = store && store.state ? store.state.tabBarList : null
|
||||
return isTabBarRootPage(currentRoute, tabBarList)
|
||||
} catch (e) {
|
||||
return false
|
||||
}
|
||||
return _isCurrentPageTabBarRootPure({ store });
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -617,55 +393,23 @@ export const isCurrentPageTabBarRoot = () => {
|
||||
* @returns {boolean} 是否激活
|
||||
*/
|
||||
export const checkTabBarActive = (linkUrl, currentPageRoute, tabBarList, packageEntryTab, currentPageQuery = {}) => {
|
||||
// 1) 归一化 linkUrl：统一前导 '/' + 子包路径适配 + 去除 query
|
||||
const normalizedLink = _normalizePath(linkUrl);
|
||||
const normalizedCurrent = _normalizePath(currentPageRoute);
|
||||
return _checkTabBarActivePure(
|
||||
linkUrl,
|
||||
currentPageRoute,
|
||||
tabBarList,
|
||||
packageEntryTab,
|
||||
currentPageQuery,
|
||||
{
|
||||
noTabPages: NO_TAB_PAGES,
|
||||
pageTabMap: PAGE_TAB_MAP,
|
||||
},
|
||||
);
|
||||
};
|
||||
|
||||
if (!normalizedLink) return false;
|
||||
|
||||
// 2) 精确匹配：当前页面就是 linkUrl 指向的页面
|
||||
if (normalizedLink === normalizedCurrent) return true;
|
||||
|
||||
// 3) 独立流程页：不点亮任何 Tab
|
||||
if (NO_TAB_PAGES.has(normalizedCurrent)) return false;
|
||||
|
||||
// 4) 若传入 tabBarList，使用动态判断逻辑
|
||||
if (tabBarList && tabBarList.list && Array.isArray(tabBarList.list)) {
|
||||
const tabUrls = tabBarList.list
|
||||
.filter(item => item.link && item.link.wap_url)
|
||||
.map(item => _normalizePath(item.link.wap_url));
|
||||
|
||||
// 检查当前 linkUrl 是否是合法的 tab URL
|
||||
if (!tabUrls.includes(normalizedLink)) return false;
|
||||
|
||||
// 5) 页面级 Tab 精确绑定
|
||||
const mappedTabUrl = PAGE_TAB_MAP[normalizedCurrent];
|
||||
if (mappedTabUrl) {
|
||||
return normalizedLink === _normalizePath(mappedTabUrl);
|
||||
}
|
||||
if (mappedTabUrl === null) return false;
|
||||
|
||||
// 6) 来源记忆兜底：从哪个 Tab 跳转过来，就保持那个 Tab 高亮
|
||||
const fromTab = currentPageQuery.from_tab;
|
||||
if (fromTab) {
|
||||
const normalizedFromTab = _normalizePath(fromTab);
|
||||
if (tabUrls.includes(normalizedFromTab)) {
|
||||
return normalizedLink === normalizedFromTab;
|
||||
}
|
||||
}
|
||||
|
||||
// 7) 分包入口追踪：通过 updateCurrentRoute 写入的入口 tab
|
||||
const matchingTabUrl = _findMatchingTabUrl(currentPageRoute, tabBarList, packageEntryTab);
|
||||
if (matchingTabUrl) return normalizedLink === matchingTabUrl;
|
||||
|
||||
// 8) 同分包回退：linkUrl 和当前页面在同一分包 → 高亮
|
||||
const linkPackage = _getPackageName(normalizedLink);
|
||||
const currentPackage = _getPackageName(normalizedCurrent);
|
||||
return linkPackage && currentPackage && linkPackage === currentPackage;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
// =============================================================
|
||||
// default export - 保持 this.$util.* 旧 API 完全兼容
|
||||
// =============================================================
|
||||
|
||||
export default {
|
||||
/** 导出页面URL常量 */
|
||||
@@ -679,6 +423,12 @@ export default {
|
||||
/** page_key 到路径的映射表（统一管理所有页面） */
|
||||
PAGE_KEY_MAP,
|
||||
|
||||
/** TabBar 业务配置 */
|
||||
TAB_BAR_KEYS,
|
||||
NO_TAB_PAGES,
|
||||
PAGE_TAB_MAP,
|
||||
systemTabBarList,
|
||||
|
||||
/** 根据 page_key + params 解析实际URL */
|
||||
resolvePageUrl,
|
||||
|
||||
@@ -691,6 +441,9 @@ export default {
|
||||
/** 把 page_params 还原成对象(JSON.parse 的安全封装) */
|
||||
parsePageParams,
|
||||
|
||||
/** HTML 实体解码 */
|
||||
decodeEntity,
|
||||
|
||||
/**
|
||||
* 递归清理任意对象/数组中所有"看起来像 URL"的字符串字段:
|
||||
* - 去除反引号 / 各种空白 / 零宽字符
|
||||
@@ -701,38 +454,8 @@ export default {
|
||||
* - 不命中: 原样保留(name / title / 标识符等普通字符串字段不被误伤)
|
||||
*
|
||||
* 设计: 不限定 key 列表,递归遍历,新加任何 URL 字段都自动覆盖
|
||||
*
|
||||
* @param {*} value 任意值
|
||||
* @returns {*} 与输入同结构的清理后值
|
||||
*/
|
||||
cleanParamUrls(value) {
|
||||
// 内部递归函数,通过闭包引用自身,避免 this 绑定问题
|
||||
const _clean = (v) => {
|
||||
if (v === null || v === undefined) return v;
|
||||
if (typeof v === 'string') {
|
||||
if (/:\/\//i.test(v)) {
|
||||
return v
|
||||
.split('').filter(ch =>
|
||||
ch !== '`' && ch !== ' ' && ch !== '\t' && ch !== '\n' && ch !== '\r',
|
||||
).join('')
|
||||
.replace(/^(https?:\/\/)\/+/i, '$1');
|
||||
}
|
||||
return v;
|
||||
}
|
||||
if (Array.isArray(v)) {
|
||||
return v.map(item => _clean(item));
|
||||
}
|
||||
if (typeof v === 'object') {
|
||||
const out = {};
|
||||
for (const k of Object.keys(v)) {
|
||||
out[k] = _clean(v[k]);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
return v;
|
||||
};
|
||||
return _clean(value);
|
||||
},
|
||||
cleanParamUrls,
|
||||
|
||||
/** 判断给定路径是否是 TabBar 根页面（用于动态控制返回按钮显示） */
|
||||
isTabBarRootPage,
|
||||
@@ -740,6 +463,28 @@ export default {
|
||||
/** 判断当前页面是否是 TabBar 根页面（供业务组件在弹窗前判断是否需要隐藏 TabBar） */
|
||||
isCurrentPageTabBarRoot,
|
||||
|
||||
/** 检查 tabBar 是否激活(动态 tabBar 高亮判断) */
|
||||
checkTabBarActive,
|
||||
|
||||
/** 子包路径前缀映射(/pages/order/ → /pages_order/) */
|
||||
adaptSubpackageUrl,
|
||||
|
||||
/**
|
||||
* URL 规范化(严格规范化已有部分,绝不自动补 https / host)
|
||||
* @see util-navigate.js#normalizeUrl
|
||||
*/
|
||||
normalizeUrl(urlString) {
|
||||
return _normalizeUrlBase(urlString);
|
||||
},
|
||||
|
||||
/**
|
||||
* 给 URL 追加 query 参数(已存在的 key 会被覆盖)
|
||||
* @see util-navigate.js#appendQueryParams
|
||||
*/
|
||||
appendQueryParams(url, params) {
|
||||
return _appendQueryParamsBase(url, params);
|
||||
},
|
||||
|
||||
/**
|
||||
* 页面跳转
|
||||
* @param {string} to 跳转链接 /pages/idnex/index
|
||||
@@ -777,41 +522,15 @@ export default {
|
||||
merged.page_params = page_params;
|
||||
}
|
||||
|
||||
// 3. 参数编码策略,按平台区分:
|
||||
// 3. 参数编码策略(委托给 util-navigate 的 _safeEncodeForPlatform)
|
||||
// - 小程序/App: uni.navigateTo / router.pushUrl 内部会自动对 url 做一次编码,
|
||||
// 若在 JS 侧再 encodeURIComponent 一次,会被平台再编码一层,目标页 onLoad(options)
|
||||
// 只 decode 一次后仍是编码形态(如 %25E6%25B2%2599%25E5%258F%2591 -> %E6%B2%99%E5%8F%91)
|
||||
// => 这里必须保持原始值,完全交给平台去编码
|
||||
// - H5: 浏览器不会自动编码 url,若参数含 & ? = 等特殊字符会被 queryString 错位解析
|
||||
// => 这里仍需手动 encodeURIComponent,decode->encode roundtrip 兼容调用方已编码的入参
|
||||
const safeEncode = (v) => {
|
||||
// 对象/数组走 JSON.stringify,避免 String({}) 退化成 "[object Object]"
|
||||
const s = _toParamValueString(v);
|
||||
// #ifdef H5
|
||||
try {
|
||||
return encodeURIComponent(decodeURIComponent(s));
|
||||
} catch (e) {
|
||||
return encodeURIComponent(s);
|
||||
}
|
||||
// #endif
|
||||
// #ifndef H5
|
||||
// 非 H5:uni.navigateTo / router.pushUrl 内部会再对 url 整体编码一次。
|
||||
// 如果调用方已经手动 encode 过 page_params (或上游已经 encode 过的 url 字符串),
|
||||
// 这里再走一遍就会出现双重编码(形如 %25xx)。
|
||||
// 兜底:仅当输入里包含 %xx 这种"看起来是已编码"的模式时,先 decode 一次,让 uni 再 encode 时得到单层编码。
|
||||
// 原始字符串(没有 %xx)不受影响,避免误把含 % 的原文吃掉。
|
||||
if (/%[0-9a-fA-F]{2}/.test(s)) {
|
||||
try {
|
||||
return decodeURIComponent(s);
|
||||
} catch (e) {
|
||||
return s;
|
||||
}
|
||||
}
|
||||
return s;
|
||||
// #endif
|
||||
};
|
||||
const queryStr = Object.keys(merged)
|
||||
.map(k => safeEncode(k) + '=' + safeEncode(merged[k]))
|
||||
.map(k => _safeEncodeForPlatform(k) + '=' + _safeEncodeForPlatform(merged[k]))
|
||||
.join('&');
|
||||
|
||||
let url = path + (queryStr ? '?' + queryStr : '');
|
||||
@@ -877,14 +596,14 @@ export default {
|
||||
const cleanUrl = url.split('?')[0];
|
||||
const isDiyTabRoot = diyTabBar.list.some(item => {
|
||||
if (!item || !item.link || !item.link.wap_url) return false;
|
||||
const normalizedTab = _normalizePath(item.link.wap_url);
|
||||
const normalizedUrl = _normalizePath(cleanUrl);
|
||||
const normalizedTab = adaptSubpackageUrl(item.link.wap_url.startsWith('/') ? item.link.wap_url : '/' + item.link.wap_url).split('?')[0];
|
||||
const normalizedUrl = adaptSubpackageUrl(cleanUrl.startsWith('/') ? cleanUrl : '/' + cleanUrl).split('?')[0];
|
||||
return normalizedTab === normalizedUrl;
|
||||
});
|
||||
if (isDiyTabRoot) {
|
||||
const adaptedUrl = adaptSubpackageUrl(cleanUrl);
|
||||
const inSystemTabBar = systemTabBarList.some(sysUrl => adaptedUrl === sysUrl || cleanUrl === sysUrl);
|
||||
// 首页用switchTab，其他DIY tab根页用reLaunch确保页面栈干净
|
||||
// 首页用switchTab，其他DIY tab根页用reLaunch确保页面栈干净
|
||||
let navApi = inSystemTabBar ? (adaptedUrl === INDEX_PAGE_URL ? uni.switchTab : uni.reLaunch) : uni.reLaunch;
|
||||
|
||||
// 鸿蒙元服务环境下 uni.switchTab 有兼容性问题, 全部使用 reLaunch
|
||||
@@ -1363,7 +1082,7 @@ export default {
|
||||
} else {
|
||||
fallbackFunc && fallbackFunc();
|
||||
}
|
||||
// #endif
|
||||
// #endif
|
||||
},
|
||||
|
||||
/**
|
||||
@@ -2087,212 +1806,4 @@ export default {
|
||||
return newObj;
|
||||
},
|
||||
|
||||
/**
|
||||
* 适用于 UniApp 的全平台 URL 标准化函数
|
||||
* @param {string} urlString - 需要标准化的原始 URL 字符串
|
||||
* @returns {string} 标准化后的 URL;若输入无法解析为合法 URL 则返回空串 ''
|
||||
*
|
||||
* 严格策略(只规范化已有部分,绝不自动补充):
|
||||
* 1) 预清理: 剥离反引号 / 各种空白 / BOM / 零宽字符(脏数据兜底)
|
||||
* 2) 不补 https:// —— 如果原串没有协议,保持没有
|
||||
* 3) 不补 host —— 如果原串没有 host,保持没有
|
||||
* 4) 只对真实存在的部分做规范化: 协议小写、host 小写、path 解析 . ..、合并多 /、去默认端口、query 排序
|
||||
* 5) scheme 后只允许恰好 2 个 '/',不允许 https:////host 这类畸形,遇到就返回 ''
|
||||
*/
|
||||
normalizeUrl(urlString) {
|
||||
if (!urlString || typeof urlString !== 'string') return '';
|
||||
|
||||
// 1) 预清理: 反引号 + 所有 ASCII 空白 + 中文全角空白 + BOM + 零宽字符
|
||||
let url = urlString
|
||||
.split('').filter(function (ch) {
|
||||
const code = ch.charCodeAt(0);
|
||||
if (code <= 0x20) return false; // ASCII 空白
|
||||
if (ch === '`') return false; // 反引号
|
||||
if (code === 0x3000) return false; // 全角空格
|
||||
if (code === 0xFEFF || code === 0x200B ||
|
||||
code === 0x200C || code === 0x200D ||
|
||||
code === 0x2060) return false; // BOM / 零宽
|
||||
return true;
|
||||
}).join('');
|
||||
|
||||
// 解析协议(可选,允许缺失)
|
||||
const protocolMatch = url.match(/^(https?):\/\//i);
|
||||
let protocol = '';
|
||||
let rest = url;
|
||||
if (protocolMatch) {
|
||||
protocol = protocolMatch[1].toLowerCase() + '://';
|
||||
rest = url.substring(protocolMatch[0].length);
|
||||
// scheme 后不能紧跟 '/',即不允许 https:////host 这种畸形
|
||||
if (rest.charAt(0) === '/') {
|
||||
console.warn('[normalizeUrl] scheme 后有多余的 /:', urlString);
|
||||
return '';
|
||||
}
|
||||
} else {
|
||||
// 没有协议 —— 不自动补,只取 path 部分
|
||||
rest = url;
|
||||
}
|
||||
|
||||
// 解析 hash(可选,允许缺失)
|
||||
const hashIndex = rest.indexOf('#');
|
||||
let hash = '';
|
||||
let mainPart = rest;
|
||||
if (hashIndex !== -1) {
|
||||
hash = rest.substring(hashIndex);
|
||||
mainPart = rest.substring(0, hashIndex);
|
||||
}
|
||||
|
||||
// 解析 query(可选,允许缺失)
|
||||
const queryIndex = mainPart.indexOf('?');
|
||||
let query = '';
|
||||
let pathPart = mainPart;
|
||||
if (queryIndex !== -1) {
|
||||
query = mainPart.substring(queryIndex); // 包含 '?'
|
||||
pathPart = mainPart.substring(0, queryIndex);
|
||||
}
|
||||
|
||||
// 解析 host(可选,允许缺失)
|
||||
let hostname = '';
|
||||
let port = '';
|
||||
let pathname = pathPart;
|
||||
if (protocol) {
|
||||
// 有协议,前一段视为 host(可能为 'host'、'host:port'、'' 三种)
|
||||
const firstSlash = pathPart.indexOf('/');
|
||||
const hostPort = firstSlash === -1 ? pathPart : pathPart.substring(0, firstSlash);
|
||||
pathname = firstSlash === -1 ? '' : pathPart.substring(firstSlash); // 保留前导 '/'
|
||||
if (hostPort) {
|
||||
const colonIdx = hostPort.lastIndexOf(':');
|
||||
if (colonIdx !== -1) {
|
||||
hostname = hostPort.substring(0, colonIdx);
|
||||
port = hostPort.substring(colonIdx + 1);
|
||||
} else {
|
||||
hostname = hostPort;
|
||||
}
|
||||
}
|
||||
}
|
||||
// 无协议时,pathPart 整体视为 pathname,host 保持空
|
||||
|
||||
// 规范化 host
|
||||
let lowerHostname = '';
|
||||
if (hostname) {
|
||||
lowerHostname = hostname.toLowerCase();
|
||||
// 去默认端口
|
||||
if ((protocol === 'http://' && port === '80') ||
|
||||
(protocol === 'https://' && port === '443')) {
|
||||
port = '';
|
||||
}
|
||||
// host 内不允许出现 '/' 或空白(若出现,视为脏数据)
|
||||
if (/[\/\s]/.test(lowerHostname)) {
|
||||
console.warn('[normalizeUrl] host 含非法字符:', urlString);
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
// 规范化 pathname: 解析 . 和 ..,合并连续 /
|
||||
let normalizedPath = pathname;
|
||||
if (normalizedPath) {
|
||||
const segments = normalizedPath.split('/');
|
||||
const resolved = [];
|
||||
for (let i = 0; i < segments.length; i++) {
|
||||
const seg = segments[i];
|
||||
if (seg === '' || seg === '.') {
|
||||
// 保留前导空段(对应开头的 /),其余空段和 '.' 跳过
|
||||
if (i === 0) resolved.push('');
|
||||
continue;
|
||||
}
|
||||
if (seg === '..') {
|
||||
// 不能跨越最顶层
|
||||
if (resolved.length > 1) resolved.pop();
|
||||
continue;
|
||||
}
|
||||
resolved.push(seg);
|
||||
}
|
||||
// 合并连续 '/' 已经在 split/join 中自然完成
|
||||
normalizedPath = resolved.join('/') || '/';
|
||||
}
|
||||
|
||||
// 规范化 query: 按 key 字母序排序
|
||||
let normalizedQuery = '';
|
||||
if (query) {
|
||||
const qs = query.substring(1); // 去 '?'
|
||||
if (qs) {
|
||||
const pairs = qs.split('&').map(function (pair) {
|
||||
const eqIdx = pair.indexOf('=');
|
||||
return eqIdx === -1
|
||||
? { k: pair, v: '' }
|
||||
: { k: pair.substring(0, eqIdx), v: pair.substring(eqIdx + 1) };
|
||||
});
|
||||
pairs.sort(function (a, b) { return a.k.localeCompare(b.k); });
|
||||
normalizedQuery = '?' + pairs.map(function (p) { return p.k + '=' + p.v; }).join('&');
|
||||
}
|
||||
}
|
||||
|
||||
// 拼回最终 URL(只包含真实存在的部分)
|
||||
const portStr = port ? ':' + port : '';
|
||||
const hostPart = lowerHostname ? lowerHostname + portStr : '';
|
||||
const schemeAndHost = protocol + hostPart; // protocol 形如 'https://',hostPart 可能为空
|
||||
return schemeAndHost + normalizedPath + normalizedQuery + hash;
|
||||
},
|
||||
|
||||
/**
|
||||
* UniApp 全平台通用的 URL 追加查询参数函数（自动处理中文编码）
|
||||
* @param {string} url - 原始 URL 字符串
|
||||
* @param {object} params - 需要追加的参数对象，例如 { name: '张三', city: '苏州' }
|
||||
* @returns {string} 追加参数后的完整 URL
|
||||
*/
|
||||
appendQueryParams(url, params) {
|
||||
if (!url || typeof url !== 'string') return '';
|
||||
|
||||
// ==================== H5 端处理 (利用原生 URL API) ====================
|
||||
// #ifdef H5
|
||||
try {
|
||||
let targetUrl = url.trim();
|
||||
if (!/^https?:\/\//i.test(targetUrl)) {
|
||||
targetUrl = 'https://' + targetUrl;
|
||||
}
|
||||
const urlObj = new URL(targetUrl);
|
||||
for (const [key, value] of Object.entries(params)) {
|
||||
if (value !== undefined && value !== null) {
|
||||
// 对象/数组走 JSON.stringify,避免 String({}) 退化成 "[object Object]"
|
||||
urlObj.searchParams.append(key, _toParamValueString(value));
|
||||
}
|
||||
}
|
||||
return urlObj.toString();
|
||||
} catch (e) {
|
||||
console.error('H5端 URL 参数追加失败:', e);
|
||||
return url;
|
||||
}
|
||||
// #endif
|
||||
|
||||
// ==================== 非 H5 端处理 (小程序 / App) ====================
|
||||
// #ifndef H5
|
||||
try {
|
||||
let targetUrl = url.trim();
|
||||
// 分离 hash (#部分)，避免干扰参数拼接
|
||||
const hashIndex = targetUrl.indexOf('#');
|
||||
let hash = '';
|
||||
if (hashIndex !== -1) {
|
||||
hash = targetUrl.substring(hashIndex);
|
||||
targetUrl = targetUrl.substring(0, hashIndex);
|
||||
}
|
||||
|
||||
// 判断当前 URL 是否已经包含查询参数，决定使用 ? 还是 &
|
||||
const separator = targetUrl.includes('?') ? '&' : '?';
|
||||
|
||||
// 遍历参数对象，拼接参数
|
||||
// 小程序/App 端:uni.navigateTo/router.pushUrl 内部会自动对 url 编码,
|
||||
// 这里不能再 encodeURIComponent,否则会被平台再编码一层导致双重编码
|
||||
const queryString = Object.entries(params)
|
||||
.filter(([_, value]) => value !== undefined && value !== null)
|
||||
// 对象/数组走 JSON.stringify,避免 String({}) 退化成 "[object Object]"
|
||||
.map(([key, value]) => `${key}=${_toParamValueString(value)}`)
|
||||
.join('&');
|
||||
|
||||
// 重新拼接成完整的 URL
|
||||
return `${targetUrl}${separator}${queryString}${hash}`;
|
||||
} catch (e) {
|
||||
console.error('非H5端 URL 参数追加失败:', e);
|
||||
return url;
|
||||
}
|
||||
// #endif
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user