mix-public 1.2.3 → 1.2.4

package/README.md

@@ -97,3 +97,4 @@
 - v1.2.1 标题栏样式兼容调整
 - v1.2.2 添加获取当前页面是否使用原生标题方法
 - v1.2.3 修复获取页面信息方法导入错误
+- v1.2.4 修复首页 tabbar 图片及PAG动画文件宽度问题

package/docs/01./346/241/206/346/236/266/344/273/213/347/273/215/01.README.md

@@ -0,0 +1,84 @@
+---
+title: 目录结构
+date: 2023-08-07 11:37:11
+permalink: /pages/8f427a/
+categories:
+  - 前端军刀
+  - 框架介绍
+tags:
+  -
+author:
+  name: ABpasser
+---
+
+# MIX-PUBLIC
+
+### 说明
+
+- MIXAPP依赖，用于web/app开发
+
+### 安装方法
+
+  ```javascript
+    // npm
+    npm i mix-public
+    // yarn
+    yarn mix-public
+    // pnpm
+    pnpm i mix-public
+  ```
+
+### 初始化方式
+
+  ```javascript
+    // 布局使用(入口文件)
+    import mixRender from "mix-public"
+
+    const mixPublicLib = mixRender({
+      mixProjectType: mixProjectType, // 项目类型: 在服务端创建的项目标识
+      mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
+      mixAppKey: mixAppKey, // appKey: 当前APPKey
+      mixApptype: mixApptype, // app类型: web/app
+      mixDeviceInfo: mixDeviceInfo // 项目版本号: 服务端的版本标识
+    });
+    import 'mix-public/mixRender.css'; // 引入web端app基础样式
+     // mixPublicLib为原生基础调用方法，可在页面使用
+
+    // 方法调用
+    import mixRender from "mix-public"
+    const PublicLib = mixRender({
+      mixJustMethod: true,
+      mixApptype: apptype, // app类型: web/app
+      mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
+    });
+  ```
+
+### 生命周期
+
+  ```javascript
+    // 页面加载
+    OnloadPage((op)=>{
+      // op为上一个页面的跳转参数
+    })
+
+    //页面返回
+    //immediate:是否立即执行
+    OnStartLoad(()=>{
+      // 在返回至当前页面时执行
+    },{immediate:false})
+  ```
+
+### 方法使用方式
+
+  ```javascript
+
+    // 调用类型
+    //1.直接调用类
+    mixPublicLib.PutCookieInfo('key','value')
+    //2.同步返回类
+    const result = mixPublicLib.GetCookieInfo('key')
+    //1.异步返回类
+    mixPublicLib.UploadPhoto({PhotoCount:1, isCut:true, Quality:1}).then(file=>{
+      console.log(file)
+    })
+  ```

package/docs/01./346/241/206/346/236/266/344/273/213/347/273/215/04./345/277/253/351/200/237/344/270/212/346/211/213.md

@@ -11,74 +11,56 @@ tags:
 author: 
   name: ABpasser
 ---
-# MIX-PUBLIC
 
-### 说明
+# 快速上手
 
-- MIXAPP依赖，用于web/app开发
+## APP开发流程
 
-### 安装方法
+1. 创建项目
+- (TODO:需补充完整创建项目流程)
 
-  ```javascript
-    // npm
-    npm i mix-public
-    // yarn
-    yarn mix-public
-    // pnpm
-    pnpm i mix-public
-  ```
+2. 配置底部导航
+- 导航分类(针对不同权限首页配置)
+```javascript
+  //配置当前账号类型
+  mixPublicLib.SetAccountType('accountType')
+  // 进入首页(根据配置的账号选择对应的页面作为一级页面加载)
+  mixPublicLib.GotoMain();
+```
+- 其他配置根据页面实际情况进行配置
 
-### 初始化方式
+3. 版本配置(作用于APP更新提示)
 
-  ```javascript
-    // 布局使用(入口文件)
-    import mixRender from "mix-public"
+4. 页面配置(实际情况进行配置)
 
-    const mixPublicLib = mixRender({
-      mixProjectType: mixProjectType, // 项目类型: 在服务端创建的项目标识
-      mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
-      mixAppKey: mixAppKey, // appKey: 当前APPKey
-      mixApptype: mixApptype, // app类型: web/app
-      mixDeviceInfo: mixDeviceInfo // 项目版本号: 服务端的版本标识
-    });
-    import 'mix-public/mixRender.css'; // 引入web端app基础样式
-     // mixPublicLib为原生基础调用方法，可在页面使用
+5. 前端项目创建
+- 配置上述流程生成的参数(Apptype/ProjectType/Version/AppKey/Apptype)
+- 在需要调用方法的页面中引入
+```javascript
+  import mixRender from "mix-public"
+  const PublicLib = mixRender({
+    mixJustMethod: true,
+    mixApptype: apptype, // app类型: web/app
+    mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
+  });
+```
+- 在需要页面配置及方法调用的页面引入
+```javascript
+  import mixRender from "mix-public"
+  const mixPublicLib = mixRender({
+    mixProjectType: mixProjectType, // 项目类型: 在服务端创建的项目标识
+    mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
+    mixAppKey: mixAppKey, // appKey: 当前APPKey
+    mixApptype: mixApptype, // app类型: web/app
+    mixDeviceInfo: mixDeviceInfo // 项目版本号: 服务端的版本标识
+  });
+  import 'mix-public/mixRender.css'; // 引入web端app基础样式
+```
+- 通过mixPublicLib中的PageInfo方法获取当前页面是否需要自定义状态及标题栏样式
+```javascript
+PublicLib.PageInfo().then((res: boolean)=>{
+  // true表示当前页面使用后台配置的样式 false表示当前页面需要自定义状态及标题栏样式
+})
+```
+- 根据项目实际需求，可自行封装mixPublicLib方法
 
-    // 方法调用
-    import mixRender from "mix-public"
-    const PublicLib = mixRender({
-      mixJustMethod: true,
-      mixApptype: apptype, // app类型: web/app
-      mixVersion: mixVersion, // 项目版本号: 服务端的版本标识
-    });
-  ```
-
-### 生命周期
-
-  ```javascript
-    // 页面加载
-    OnloadPage((op)=>{
-      // op为上一个页面的跳转参数
-    })
-
-    //页面返回
-    //immediate:是否立即执行
-    OnStartLoad(()=>{
-      // 在返回至当前页面时执行
-    },{immediate:false})
-  ```
-
-### 方法使用方式
-
-  ```javascript
-
-    // 调用类型
-    //1.直接调用类
-    mixPublicLib.PutCookieInfo('key','value')
-    //2.同步返回类
-    const result = mixPublicLib.GetCookieInfo('key')
-    //1.异步返回类
-    mixPublicLib.UploadPhoto({PhotoCount:1, isCut:true, Quality:1}).then(file=>{
-      console.log(file)
-    })
-  ```

package/docs/{api → 02.API}//351/241/265/351/235/242/350/267/263/350/275/254/001-Goto.md

@@ -34,7 +34,7 @@ Goto(option: {
 |--------|------|------|------|--------|
 | Url | string | 是 | 跳转目标页面路径或 URL | - |
 | Params | object | 否 | 传递的参数对象 | {} |
-| OutSide | boolean | 否 | 是否在浏览器中打开（仅 http URL 有效） | false |
+| OutSide | boolean | 否 | 是否在浏览器中打开（仅 http URL 有效,无法携带 params） | false |
 
 ### 返回值说明
 
@@ -51,6 +51,12 @@ mixPublicLib.Goto({
   Params: { from: "home" }
 });
 
+// user-login页面
+OnloadPage((op)=>{
+  console.log(op) // { from: "home" }
+  console.log(op.from) // home
+})
+
 // 跳转外部网页（在当前应用内打开）
 mixPublicLib.Goto({ 
   Url: "https://www.example.com"
@@ -66,11 +72,12 @@ mixPublicLib.Goto({
 mixPublicLib.Goto({ 
   Url: "MiniApp?MiniAppId=appid&OnlineUrl=onlineurl&JumpUrl=miniapppagename"
 });
+
 ```
 
 ### TypeScript 示例
 
-```
+```javascript
 import type { GotoType } from './paramsTypes';
 
 const options: GotoType = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mix-public",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "use mix-app",
   "main": "mixRender.js",
   "scripts": {

package/pageRender/tabbar.js

@@ -47,7 +47,7 @@ export default (op) => {
                     tabbar.innerHTML += `
                     <div class="mix-tab-item" tab-name="${item.pageName}" tab-text-select-color="${formatColor(item.selectTextColor)}" tab-text-normal-color="${formatColor(item.normalTextColor)}" style="background-color: ${formatColor(item.backgroudColor) || '#fff'};">
                         <div class="mix-tab-item-img">
-                            <img style="width:${item.iconSize}px;height:${item.iconSize}px;" src="${item.pageName === tabCurrentPageName ? item.selectIcon : item.normalIcon}" alt="">
+                            <img style="width:${375 / Number(item.iconSize)}vw;height:${375 / Number(item.iconSize)}vw;" src="${item.pageName === tabCurrentPageName ? item.selectIcon : item.normalIcon}" alt="">
                         </div>
                         <div class="mix-tab-item-text" style="color: ${formatColor(item.pageName === tabCurrentPageName ? item.selectTextColor : item.normalTextColor)}">${unescape(item.title)}</div>
                         <div class="mix-tab-item-badge"></div>
@@ -56,7 +56,7 @@ export default (op) => {
                     tabbar.innerHTML += `
                     <div class="mix-tab-item" tab-name="${item.pageName}" tab-text-select-color="${formatColor(item.selectTextColor)}" tab-text-normal-color="${formatColor(item.normalTextColor)}" style="background-color: ${formatColor(item.backgroudColor) || '#fff'};">
                         <div class="mix-tab-item-img">
-                        ${item.pageName === tabCurrentPageName ? `<canvas class="canvas" id="mix-tab-pag"style="width:${item.iconSize}px;height:${item.iconSize}px;">` : '<img style="width:' + item.iconSize + 'px;height:' + item.iconSize + 'px;" src="' + item.pagDefaultIcon + '" alt=""></img>'
+                        ${item.pageName === tabCurrentPageName ? `<canvas class="canvas" id="mix-tab-pag"style="width:${375 / Number(item.iconSize)}vw;height:${375 / Number(item.iconSize)}vw;">` : '<img style="width:' + 375 / Number(item.iconSize) + 'vw;height:' + 375 / Number(item.iconSize) + 'vw;" src="' + item.pagDefaultIcon + '" alt=""></img>'
                         }
                         </div>
                         <div class="mix-tab-item-text" style="color: ${formatColor(item.pageName === tabCurrentPageName ? item.selectTextColor : item.normalTextColor)}">${unescape(item.title)}</div>

package/docs/01./346/241/206/346/236/266/344/273/213/347/273/215/01./347/233/256/345/275/225/347/273/223/346/236/204.md

@@ -1,16 +0,0 @@
----
-title: 目录结构
-date: 2023-08-07 11:37:11
-permalink: /pages/8f427a/
-categories:
-  - 前端军刀
-  - 框架介绍
-tags:
-  -
-author:
-  name: ABpasser
----
-
-## 目录介绍
-
-## 文件介绍

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/01.Goto.md

@@ -1,68 +0,0 @@
----
-title: Goto
-date: 2024-08-26 14:31:34
-permalink: /pages/6d2301/
-categories:
-  - docs
-  - 前端军刀
-  - JS-App接口文档
-  - 页面跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# APP内部页面跳转
-
-## 调用类型: 直接调用类
-
-## Goto
-
-| 方法名 | 参数 |  使用说明 |
-| :----- | :-----: |  -----: |
-| Goto | {Url: '跳转地址'} | APP跳转方法 |
-
-```javascript
-/*
-* params: 
-* {
-*   Url: 跳转地址 必填
-*   Params: 跳转参数 非必填
-*   OutSide: 是否跳转浏览器打开页面 非必填
-* }
-*/
-
-PublicLib.Goto({Url: 'index',Params: {id: 1}, OutSide: false});
-```
-
-
-### Url参数说明: 
-1. 外部网页跳转
-  ```javascript 
-  PublicLib.Goto({Url: 'http://www.baidu.com' });
-  ```
-2. 站内小程序跳转
-  ```javascript 
-  PublicLib.Goto({Url: 'MiniApp?MiniAppId=appid&OnlineUrl=onlineurl&JumpUrl=miniapppagename' });
-  ```
-3. APP注册页面跳转
-  ```javascript 
-  PublicLib.Goto({Url: 'index' });
-  ```
-### 其他使用说明:
-1. APP注册页面带参数跳转
-  ```javascript 
-  <!-- A页面 -->
-  PublicLib.Goto({Url: 'index?id=1' });
-  PublicLib.Goto({Url: 'index', Params: {id: 1} });
-  <!-- B页面 -->
-  OnloadPage((op)=>{
-    console.log(op) // {id:1}
-    console.log(opid) // 1
-  })
-  ```
-2. APP跳转浏览器打开三方网页
-  ```javascript 
-  PublicLib.Goto( {Url: 'http://www.baidu.com', OutSide: true });
-  ```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/02.GotoMain.md

@@ -1,33 +0,0 @@
----
-title: GotoMain
-date: 2024-09-19 17:30:21
-permalink: /pages/05e709/
-categories:
-  - docs
-  - 前端军刀
-  - API
-  - 页面跳转
-  - 本地地址跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 进入主页
-
-## 调用类型: 直接调用类
-
-## GotoMain
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| GotoMain | 无 | 从登录页面跳转至首页 |
-
-```javascript
-/*
-* 跳转APP定义的首页(跳转下标为0的tabbar页面，需在项目中配置底部tabbar参数)
-*/
-
-PublicLib.GotoMain(); 
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/03.Drawer.md

@@ -1,61 +0,0 @@
----
-title: Drawer
-date: 2024-09-20 10:19:46
-permalink: /pages/d06a09/
-categories:
-  - docs
-  - 前端军刀
-  - API
-  - 页面跳转
-  - 本地地址跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 以侧边抽屉方式打开页面
-
-## 调用类型: 直接调用类
-
-## Drawer
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: | ----: |
-| Drawer | {Url: 'page', ClickClose: 0, WidthProportional: 0.8, Duration: 500, MaskColor: '#33FFD700'} | 以侧边抽屉方式打开新的页面(不在页面栈中) |
-
-```javascript
-/*
-* params: 
-* {
-*   Url: 跳转URL 必填
-*   ClickClose: 点击空白区域是否关闭(1:关闭 0：不关闭)，默认0 非必填
-*   Width: 抽屉宽度(取值范围：0-1)，默认0.8 非必填
-*   Height: 抽屉高度(取值范围：0-1，默认0.8 非必填
-*   AnimationDirection: 抽屉展示方向，1：左，2：上，3：右，4：下 非必填
-*   Duration: 展开关闭时间(ms)，默认500 非必填
-*   MaskColor: 背景遮罩颜色(透明度在前的十六进制透明色)，默认#33FFFFFF 非必填
-* {
-*/
-PublicLib.Drawer({
-  Url:'index',
-  ClickClose: 1,
-  Width:'0.8',
-  Height:'0.8',
-  AnimationDirection: 1,
-  Duration:'600',
-  MaskColor:'#33FFD700'
-}); 
-```
-
-## DrawerBack
-
-- 关闭以侧边抽屉方式打开的页面
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| DrawerBack | 无 | 用于关闭Drawer方法打开的页面 |
-
-```javascript
-PublicLib.DrawerBack(); 
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/04.PopupShow.md

@@ -1,57 +0,0 @@
----
-title: PopupShow
-date: 2024-09-20 10:20:17
-permalink: /pages/d10edc/
-categories:
-  - docs
-  - 前端军刀
-  - API
-  - 页面跳转
-  - 本地地址跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 以弹窗形式打开页面
-
-## 调用类型: 直接调用类
-
-## PopupShow
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| PopupShow | {Url: 'index', ClickClose: '1', Width: '0.8', Height: '0.5', MaskColor: '#33FFD700'} | 以弹窗形式打开新的页面(不在页面栈中) |
-
-```javascript
-/*
-* params: 
-* {
-*   Url: 跳转URL 必填
-*   ClickClose: 点击空白区域是否关闭(1:关闭 0：不关闭)，默认0 非必填
-*   Width: 弹窗宽度(取值范围：0-1)，默认0.7 非必填
-*   Height: 弹窗高度(取值范围：0-1)，默认0.5 非必填
-*   MaskColor: 背景遮罩颜色(不带#的十六进制透明色)，默认#33FFFFFF 非必填
-* {
-*/
-PublicLib.PopupShow({
-  Url:'index',
-  ClickClose: 1,
-  Width:'0.8',
-  Height:'0.5',
-  MaskColor:'#33FFD700'
-}); 
-```
-
-## PopupClose
-
-- 关闭以弹窗形式打开的页面
-
-| 方法名 | 参数 | 说明|
-| :----- | :----: | :----: |
-| PopupClose | 无 | 用于关闭PopupShow方法打开的页面 |
-
-```javascript
-PublicLib.PopupClose(); 
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/05.GoBack.md

@@ -1,36 +0,0 @@
----
-title: GoBack
-date: 2024-09-27 16:54:44
-permalink: /pages/c41862/
-categories:
-  - docs
-  - 前端军刀
-  - API
-  - 页面跳转
-  - 本地地址跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 返回页面方法
-
-## 调用类型: 直接调用类
-
-## GoBack
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| GoBack |{Level:1} | 返回之前的页面 |
-
-```javascript
-/*
-* params: 
-* {
-*   Level: 跳转地址(1:返回上一页 2:返回上两页，以此类推) 必填
-* {
-*/
-
-PublicLib.GoBack({Level:1}); 
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/06.ReturnHomePage.md

@@ -1,35 +0,0 @@
----
-title: ReturnHomePage
-date: 2024-10-10 17:10:52
-permalink: /pages/44ef8e/
-categories:
-  - docs
-  - 前端军刀
-  - API
-  - 页面跳转
-  - 本地地址跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 返回一级页面
-
-## 调用类型: 直接调用类
-
-## ReturnHomePage
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| ReturnHomePage |{Index:1} | 返回至APP一级页面 |
-
-```javascript
-/*
-* params: 
-* {
-*   Index: 一级页面下标 必填
-*/
-
-PublicLib.ReturnHomePage({Index:1});
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/01./351/241/265/351/235/242/350/267/263/350/275/254/07.GotoUrlByBrowse.md

@@ -1,35 +0,0 @@
----
-title: GotoUrlByBrowse
-date: 2024-08-26 14:31:34
-permalink: /pages/6d2303/
-categories:
-  - docs
-  - 前端军刀
-  - JS-App接口文档
-  - 页面跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# APP跳转默认浏览器打开URL
-
-## 调用类型: 直接调用类
-
-## GotoUrlByBrowse
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| GotoUrlByBrowse | {Url:'[http:/https:](http://baidu.com)'} | 跳转至浏览器并打开网页地址 |
-
-```javascript
-/*
-* params: (线上地址)
-* {
-*   Url: 跳转浏览器并打开网页地址 必填
-* {
-*/
-
-PublicLib.GotoUrlByBrowse({Url:'http://baidu.com'});
-```

package/docs/02.API/00./351/241/265/351/235/242/350/267/263/350/275/254/02./347/211/271/346/256/212/351/241/265/351/235/242/350/267/263/350/275/254/01.GoToVideo.md

@@ -1,39 +0,0 @@
----
-title: GoToVideo
-date: 2024-08-26 14:31:34
-permalink: /pages/6d2304/
-categories:
-  - docs
-  - 前端军刀
-  - JS-App接口文档
-  - 页面跳转
-tags:
-  - 
-author: 
-  name: ABpasser
----
-
-# 跳转新页面并加载在线VIDEO资源
-
-## 调用类型: 直接调用类
-
-## GoToVideo
-
-| 方法名 | 参数 |  说明 |
-| :----- | :----: |  :----: |
-| GoToVideo |{Url:'https://www.baidu.com',VideoUrls:'[<https://www.bilibili.com/video/BV1xi421z7SB/?spm_id_from=333.788.recommend_more_video.1>](https://www.bilibili.com/video/BV1xi421z7SB/?spm_id_from=333.788.recommend_more_video.1)'} | 跳转站内页面并插入video |
-
-```javascript
-/*
-* params: 
-* {
-*   Url: 跳转地址(本地地址:'index') 必填
-*   VideoUrls: 线上video视频地址(目前仅支持单个视频) 必填
-* {
-*/
-
-PublicLib.GoToVideo({Url:'https://www.baidu.com',VideoUrls:'https://www.bilibili.com/video/BV1xi421z7SB/?spm_id_from=333.788.recommend_more_video.1'});
-```
-
-### 调用说明: 
-1. web端仅支持跳转至三方页面