navigation.js 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. /**
  2. * H5版本的页面导航工具
  3. * 提供统一的页面跳转、返回、刷新等功能
  4. */
  5. /**
  6. * 页面导航管理器
  7. */
  8. const NavigationManager = {
  9. /**
  10. * 跳转到目标页面
  11. * @param {string} destPage - 目标页面名称(不含.html)
  12. * @param {object} params - 传递的参数
  13. * @param {object} options - 跳转选项
  14. */
  15. goTo(destPage, params = {}, options = {}) {
  16. try {
  17. const urlParams = new URLSearchParams(window.location.search);
  18. // 添加新参数
  19. Object.keys(params).forEach(key => {
  20. if (params[key] !== undefined && params[key] !== null) {
  21. urlParams.set(key, encodeURIComponent(params[key]));
  22. }
  23. });
  24. // 添加导航标记,用于返回时刷新
  25. if (options.needRefresh) {
  26. urlParams.set('_needRefresh', '1');
  27. }
  28. // 构建目标URL
  29. const newUrl = `${destPage}.html?${urlParams.toString()}`;
  30. console.log('🔗 导航到:', newUrl);
  31. console.log('📋 传递参数:', Object.fromEntries(urlParams));
  32. // 跳转页面
  33. window.location.href = newUrl;
  34. } catch (error) {
  35. console.error('❌ 页面导航失败:', error);
  36. if (typeof showToast !== 'undefined') {
  37. showToast('页面跳转失败', 'error');
  38. } else {
  39. alert('页面跳转失败');
  40. }
  41. }
  42. },
  43. /**
  44. * 处理buttonList按钮跳转
  45. * @param {object} button - 按钮配置
  46. */
  47. goToFromButton(button) {
  48. // 优先检查function.dest,然后是button.dest
  49. const rawDestPage = button.function?.dest || button.dest;
  50. // 功能说明:后端返回 dest(如 objInp)时自动补齐 mp_ 前缀,统一跳转到移动端页面 by xu 2026-02-28
  51. const destPage = (() => {
  52. const target = String(rawDestPage || '').trim();
  53. if (!target) return '';
  54. if (target.startsWith('mp_')) return target;
  55. return `mp_${target}`;
  56. })();
  57. console.log("goToFromButton:",destPage)
  58. if (!destPage) {
  59. console.warn('按钮没有配置跳转页面:', button);
  60. return false;
  61. }
  62. const params = {
  63. dest: destPage,
  64. title: button.function?.desc || button.function?.title || button.desc || button.title || button.buttonName || button.name || '',
  65. service: button.function?.servName || button.servName || button.service || ''
  66. };
  67. // 跳转页面,标记需要刷新
  68. this.goTo(destPage, params, { needRefresh: true });
  69. return true;
  70. },
  71. /**
  72. * 返回上一页
  73. * @param {object} options - 返回选项
  74. */
  75. goBack(options = {}) {
  76. try {
  77. // 检查是否需要刷新父页面
  78. const urlParams = new URLSearchParams(window.location.search);
  79. const needRefresh = urlParams.get('_needRefresh') === '1';
  80. if (needRefresh && options.refreshParent !== false) {
  81. // 通知父页面刷新
  82. this.notifyParentRefresh();
  83. }
  84. // 返回上一页
  85. if (window.history.length > 1) {
  86. window.history.back();
  87. } else {
  88. NavigationManager.goBack()
  89. }
  90. } catch (error) {
  91. console.error('❌ 页面返回失败:', error);
  92. if (typeof showToast !== 'undefined') {
  93. showToast('页面返回失败', 'error');
  94. }
  95. }
  96. },
  97. /**
  98. * 通知父页面刷新(通过localStorage)
  99. */
  100. notifyParentRefresh() {
  101. try {
  102. const refreshData = {
  103. timestamp: Date.now(),
  104. action: 'refresh',
  105. source: window.location.pathname
  106. };
  107. localStorage.setItem('_pageRefreshNotify', JSON.stringify(refreshData));
  108. // 触发storage事件
  109. window.dispatchEvent(new StorageEvent('storage', {
  110. key: '_pageRefreshNotify',
  111. newValue: JSON.stringify(refreshData)
  112. }));
  113. console.log('📢 通知父页面刷新');
  114. } catch (error) {
  115. console.error('❌ 通知父页面刷新失败:', error);
  116. }
  117. },
  118. /**
  119. * 监听页面刷新通知
  120. * @param {function} callback - 刷新回调函数
  121. */
  122. onRefreshNotify(callback) {
  123. if (typeof callback !== 'function') {
  124. console.warn('刷新回调必须是函数');
  125. return;
  126. }
  127. // 监听localStorage变化
  128. const handleStorageChange = (event) => {
  129. if (event.key === '_pageRefreshNotify' && event.newValue) {
  130. try {
  131. const refreshData = JSON.parse(event.newValue);
  132. console.log('📢 收到页面刷新通知:', refreshData);
  133. // 执行刷新回调
  134. callback(refreshData);
  135. // 清除通知
  136. localStorage.removeItem('_pageRefreshNotify');
  137. } catch (error) {
  138. console.error('❌ 处理刷新通知失败:', error);
  139. }
  140. }
  141. };
  142. window.addEventListener('storage', handleStorageChange);
  143. // 返回清理函数
  144. return () => {
  145. window.removeEventListener('storage', handleStorageChange);
  146. };
  147. },
  148. /**
  149. * 刷新当前页面数据
  150. * @param {function} refreshCallback - 刷新数据的回调函数
  151. */
  152. refreshCurrentPage(refreshCallback) {
  153. if (typeof refreshCallback === 'function') {
  154. console.log('🔄 刷新当前页面数据');
  155. refreshCallback();
  156. } else {
  157. // 默认刷新整个页面
  158. window.location.reload();
  159. }
  160. },
  161. /**
  162. * 获取URL参数
  163. * @param {string} key - 参数名,不传则返回所有参数
  164. * @returns {string|object} 参数值或参数对象
  165. */
  166. getUrlParam(key) {
  167. const urlParams = new URLSearchParams(window.location.search);
  168. if (key) {
  169. const value = urlParams.get(key);
  170. return value ? decodeURIComponent(value) : null;
  171. }
  172. // 返回所有参数
  173. const params = {};
  174. for (const [paramKey, paramValue] of urlParams) {
  175. params[paramKey] = decodeURIComponent(paramValue);
  176. }
  177. return params;
  178. }
  179. };
  180. // 导出到全局
  181. window.NavigationManager = NavigationManager;
  182. // 兼容性:也导出为全局函数
  183. window.goTo = NavigationManager.goTo.bind(NavigationManager);
  184. window.goBack = NavigationManager.goBack.bind(NavigationManager);
  185. window.getUrlParam = NavigationManager.getUrlParam.bind(NavigationManager);
  186. console.log('✅ H5页面导航工具加载完成');