添加 navigate_page 和 rediect_page 方法

usertool.js

@@ -16,9 +16,9 @@ export default {
   BACKEND_DEFAULT: 'SERVER', // 服务器 SERVER 或云服务 UNICLOUD
 
   thisPage () {
-    return this.__page__ ? this // 1) constructor.name==='VueComponent' 只在 development 环境有用，在 production 环境会被简化成 'o'。2)对于组件内定义的 i18nText，要使用 this 来获得组建内的 i18nText，而不是 getCurrentPages[...] 去访问全局页面的 i18nText。 
+    return this.__page__
-      : ( getCurrentPages()[getCurrentPages().length - 1] // [20220401] 发现在 topWindow 里, getCurrentPages 是 undefined。
+      ? this // 1) constructor.name==='VueComponent' 只在 development 环境有用，在 production 环境会被简化成 'o'。2)对于组件内定义的 i18nText，要使用 this 来获得组建内的 i18nText，而不是 getCurrentPages[...] 去访问全局页面的 i18nText。
-        || {} ) // 在 App.vue 中调用 getCurrentPages() 返回的是空数组 []，因此在这里默认 {} 做保护。
+      : getCurrentPages()[getCurrentPages().length - 1] || {} // [20220401] 发现在 topWindow 里, getCurrentPages 是 undefined。 // 在 App.vue 中调用 getCurrentPages() 返回的是空数组 []，因此在这里默认 {} 做保护。
   },
 
   // 输出命令行提示，可用来取代 console.log/info/warn/error
@@ -46,25 +46,25 @@ export default {
   },
 
   localizeText (i18nText) {
-    i18nText = i18nText?.__page__ ? this.i18nText // 如果挂载到具体页面的 computed { lote: wo.localizeText } 那么 i18nText 会被自动赋值为 this 就是当前页面，直接取用 this.i18nText 即可。
+    i18nText = i18nText?.__page__
-      : ( i18nText // 如果传入i18n参数 ({zhCN:'...', enUS:'...'})
+      ? this.i18nText // 如果挂载到具体页面的 computed { lote: wo.localizeText } 那么 i18nText 会被自动赋值为 this 就是当前页面，直接取用 this.i18nText 即可。
-        || this.thisPage()?.i18nText)  // 如果不是挂载到 Vue.prototype 而是 挂载到 wo 下调用，那么 this.i18nText 就报错了。因此通过 thisPage().i18nText 访问。
+      : i18nText || this.thisPage()?.i18nText // 如果传入i18n参数 ({zhCN:'...', enUS:'...'}) // 如果不是挂载到 Vue.prototype 而是 挂载到 wo 下调用，那么 this.i18nText 就报错了。因此通过 thisPage().i18nText 访问。
     const mylang = getApp().$store.state.i18n.mylang // this.thisPage() 有可能为空（例如在 topWindow 里，或者在 App.vue 里），所以用 getApp().$store 更安全
     return i18nText?.[mylang] || (typeof i18nText === 'string' ? i18nText : '') // 必须检测是否string，如果直接返回 i18nText 可能返回{}等，导致依赖于返回空值的前端出错
   },
 
-  localeText() { // 专供绑定到 computed { lote: wo.localeText } 使用，这时 this 就是当前页面。
+  localeText () {
+    // 专供绑定到 computed { lote: wo.localeText } 使用，这时 this 就是当前页面。
     return this.i18nText?.[getApp().$store.state.i18n.mylang] || {}
   },
 
-  setBarTitles ({ windowTitle, pageTitle, 
+  setBarTitles ({ windowTitle, pageTitle, pagesJson = this.pagesJson || wo?.pagesJson, envar = this.envar || wo?.envar } = {}) {
-    pagesJson=this.pagesJson || wo?.pagesJson } = {}
-  ) {
     const mylang = getApp()?.$store?.state?.i18n?.mylang // 不要用 pageNow.$store，防止在 App.vue 里无法获取当前页面。
     const pageNow = this.thisPage() // 需要兼顾在 App.vue 时无法获取当前页面的情况，因为如果在 topWindow 里调用本函数，getApp() 和 getCurrentPages()[getCurrentPages().length-1] 就是 undefined。
 
     // #ifdef H5
-    document.title = windowTitle || wo?.envar?.Sys_Brand_Name?.[mylang] || pagesJson?.appInfo?.i18nText?.[mylang] || pagesJson?.globalStyle?.navigationBarTitleText // 必须放在 setNavigationBarTitle 之后，否则会被其覆盖掉。
+    document.title =
+      windowTitle || wo?.envar?.Sys_Brand_Name?.[mylang] || pagesJson?.appInfo?.i18nText?.[mylang] || pagesJson?.globalStyle?.navigationBarTitleText // 必须放在 setNavigationBarTitle 之后，否则会被其覆盖掉。
     // #endif
 
     uni.setNavigationBarTitle({
@@ -94,13 +94,15 @@ export default {
 
     // #ifdef H5
     // 响应式方案：仅仅根据当前设备类型，如果是 PC 大屏幕，则始终显示 topWindow 并且隐藏顶部 navibar 和底部 tabBar。
-    const envar = this.envar || wo?.envar
+    if (pagesJson?.topWindow || envar?.Hide_Bars_On_PC) {
-    if (pagesJson?.topWindow || envar.Hide_Bars_On_PC) { // 如果页头不是通过 pagesJson.topWindow 而是作为组件来引入个别页面，那么定义配置参数 Hide_Bars_On_PC 来控制。
+      // 如果页头不是通过 pagesJson.topWindow 而是作为组件来引入个别页面，那么定义配置参数 Hide_Bars_On_PC 来控制。
       if (uni.getSystemInfoSync().model === 'PC') {
         if (window.screen.width > (pagesJson?.topWindow?.matchMedia?.minWidth || 0)) {
           uni.hideTabBar()
           // 不知为何，同一个二级页面，如果第二次进入，就仍然会显示 navibar, 必须通过 setTimeout 执行才能彻底隐藏。
-          setTimeout(()=>{ document.getElementsByTagName('uni-page-head')?.[0]?.remove() },0)
+          setTimeout(() => {
+            document.getElementsByTagName('uni-page-head')?.[0]?.remove()
+          }, 0)
         }
       } else {
         document.getElementsByTagName('uni-top-window')?.[0]?.remove() // hide topWindow
@@ -126,13 +128,16 @@ export default {
       port = envar.Base_Port
     } else {
       protocol = envar.Base_Protocol_Dev || 'http'
-      hostname = envar.Base_Hostname_Dev
+      hostname =
+        envar.Base_Hostname_Dev ||
         // #ifdef H5
-        || window.location.hostname
+        window.location.hostname
       // #endif
-      port = envar.Base_Port_Dev || envar.Base_Port
+      port =
+        envar.Base_Port_Dev ||
+        envar.Base_Port ||
         // #ifdef H5
-        || window.location.port.replace(':','')
+        window.location.port.replace(':', '')
       // #endif
     }
     return `${protocol}://${hostname}:${port}/${route.replace(/^\//, '')}`
@@ -145,20 +150,6 @@ export default {
     return ''
   },
 
-  relaunchForAll ({envar=this.envar || wo?.envar || {}} = {}) {
-    uni.reLaunch({ url: envar?.Start_Page_For_All })
-  },
-  relaunchForOnline ({envar=this.envar || wo?.envar || {}} = {}) {
-    process.env.NODE_ENV === 'production' && 
-    wo.ss.User.onlineUser.uuid && 
-    uni.reLaunch({ url: envar?.Start_Page_For_Online })
-  },
-  relaunchForOffline ({envar=this.envar || wo?.envar || {}} ={}) {
-    process.env.NODE_ENV === 'production' && 
-    ! wo.ss.User.onlineUser.uuid && 
-    uni.reLaunch({ url: envar?.Start_Page_For_Offline })
-  },
-
   /** 统一 uni.request 和 uniCloud.callFunction 的调用方法，提供统一、透明的后台调用
    * 返回值：{ _state, 成功结果或错误结果 }，其中 _state 除了后台返回的，还可以是
    * - CLIENT_BACKEND_BROKEN: 前端发现后台断线
@@ -168,7 +159,10 @@ export default {
   async callBackend ({
     backend = this.envar?.Backend_Default || wo?.envar?.Backend_Default || this.BACKEND_DEFAULT,
     httpMethod = 'POST',
-    apiVersion = 'api', apiWho, apiTodo, apiWhat = {} 
+    apiVersion = 'api',
+    apiWho,
+    apiTodo,
+    apiWhat = {},
   }) {
     const thisRoute = this.thisPage()?.route || 'VueApp' // 立刻保存 this.thisPage().route，因为在调用后台后，可能已切换到了其他页面。
     const startTime = new Date().toJSON()
@@ -185,7 +179,8 @@ export default {
             // uniIdToken // uniCloud自动getStorageSync('uni_id_token')并传递为 uniIdToken；也可自行组装传入 uniIdToken
           },
         })
-        .catch((error) => { // {errMsg, stack} = error
+        .catch((error) => {
+          // {errMsg, stack} = error
           if (/request:fail/.test(error.errMsg)) {
             // 后台云服务无法连接
             return { _state: 'CLIENT_BACKEND_BROKEN', error }
@@ -228,10 +223,16 @@ export default {
     // 注意2，虽然预设了 resultServer 和 resultCloud = {}，但如果后台返回了 null，那么 resultServer/resultCloud 也是 null。
     if (process.env.NODE_ENV === 'development') {
       console.log(
-        '%c '+JSON.stringify({startTime:startTime, page:thisRoute, endTime:new Date().toJSON()}) +
+        '%c ' +
-        ' %c '+ JSON.stringify({ backend, apiWho, apiTodo, apiWhat, url }) +
+          JSON.stringify({ startTime: startTime, page: thisRoute, endTime: new Date().toJSON() }) +
-        ' %c '+ JSON.stringify(result), 
+          ' %c ' +
-        'color:blue', 'background:skyblue', 'background:magenta') // 不知为何，直接用 result 会输出一个奇怪的对象，要主动添加 JSON.stringify 才按照期望输出。
+          JSON.stringify({ backend, apiWho, apiTodo, apiWhat, url }) +
+          ' %c ' +
+          JSON.stringify(result),
+        'color:blue',
+        'background:skyblue',
+        'background:magenta'
+      ) // 不知为何，直接用 result 会输出一个奇怪的对象，要主动添加 JSON.stringify 才按照期望输出。
     }
     return result
   },
@@ -277,7 +278,8 @@ export default {
       // url 所在方法进一步处理后，通过 uploadFile 存在 data 里返回结果
       uni.hideLoading()
 
-      if (typeof(data)==='string') { // 不知为何，uni.uploadFile返回的 data 是字符串而不是对象
+      if (typeof data === 'string') {
+        // 不知为何，uni.uploadFile返回的 data 是字符串而不是对象
         try {
           data = JSON.parse(data)
         } catch (exp) {
@@ -358,8 +360,15 @@ export default {
 
   async pickupFile ({
     backend = this.envar?.Backend_Default || wo?.envar?.Backend_Default || this.BACKEND_DEFAULT,
-    mediaType = 'image', count = 1, sizeType = ['original', 'compressed'], sourceType = ['album', 'camera'], maxDuration,
+    mediaType = 'image',
-    url, header = {}, formData = {}, name = 'file',
+    count = 1,
+    sizeType = ['original', 'compressed'],
+    sourceType = ['album', 'camera'],
+    maxDuration,
+    url,
+    header = {},
+    formData = {},
+    name = 'file',
   } = {}) {
     if (backend === 'UNICLOUD') {
       const resultCloud = await this.pickupFile2Cloud({ mediaType, count, sizeType, sourceType, maxDuration })
@@ -512,16 +521,19 @@ export default {
       if (ice.candidate) {
         handleCandidate(ice.candidate.candidate)
       }
-		};
+    }
     //建立一个伪数据的通道
     pc.createDataChannel('')
-		pc.createOffer((res) => {
+    pc.createOffer(
+      (res) => {
         pc.setLocalDescription(res)
-		}, () => {})
+      },
+      () => {}
+    )
     //延迟，让一切都能完成
     setTimeout(() => {
       let lines = pc.localDescription.sdp.split('\n')
-			lines.forEach(item => {
+      lines.forEach((item) => {
         if (item.indexOf('a=candidate:') === 0) {
           handleCandidate(item)
         }
@@ -529,4 +541,29 @@ export default {
     }, 1000)
   },
 
+  relaunchForAll ({ envar = this.envar || wo?.envar } = {}) {
+    uni.reLaunch({ url: envar?.Start_Page_For_All })
+  },
+  relaunchForOnline ({ envar = this.envar || wo?.envar } = {}) {
+    process.env.NODE_ENV === 'production' && wo.ss.User.onlineUser.uuid && uni.reLaunch({ url: envar?.Start_Page_For_Online })
+  },
+  relaunchForOffline ({ envar = this.envar || wo?.envar } = {}) {
+    process.env.NODE_ENV === 'production' && ! wo.ss.User.onlineUser.uuid && uni.reLaunch({ url: envar?.Start_Page_For_Offline })
+  },
+  // 在手机上跳转到标签页需要 switchTab，在PC上跳转到菜单页需要 navigateTo 或 redirectTo。因此在这里用 gotoPage 和 backtoPage 来弥补差异。
+  navigate_page (pageName, { pagesJson = this.pagesJson || wo?.pagesJson, envar = this.envar || wo?.envar } = {}) {
+    if (! envar?.onPC && pagesJson?.tabBar?.list?.find((item) => item?.pagePath?.substr(6) === pageName)) {
+      uni.switchTab({ url: pageName })
+    } else {
+      uni.navigateTo({ url: pageName })
+    }
+  },
+  redirect_page (pageName, { pagesJson = this.pagesJson || wo?.pagesJson, envar = this.envar || wo?.envar } = {}) {
+    if (! envar?.onPC && pagesJson?.tabBar?.list?.find((item) => item?.pagePath?.substr(6) === pageName)) {
+      uni.switchTab({ url: pageName })
+    } else {
+      uni.redirectTo({ url: pageName })
+    }
+  },
+
 }