mix-public 1.2.0 → 1.2.2

package/docs/api//351/241/265/351/235/242/350/267/263/350/275/254/071-GreyAllPages.md

@@ -0,0 +1,129 @@
+---
+date: 2026-03-06
+permalink: /pages/api-grey-all-pages/
+categories: 
+  - API
+  - 页面控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# GreyAllPages - 灰度所有页面
+
+## 功能描述
+
+将应用所有页面设置为灰度显示。用于实现哀悼模式或特殊视觉效果。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+GreyAllPages(option: { 
+  isGrey: boolean; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| isGrey | boolean | 是 | 是否启用灰度模式 | false |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 启用灰度模式（哀悼模式）
+mixPublicLib.GreyAllPages({ 
+  isGrey: true 
+});
+
+// 禁用灰度模式，恢复正常显示
+mixPublicLib.GreyAllPages({ 
+  isGrey: false 
+});
+
+// 根据特定日期自动启用灰度模式
+const today = new Date();
+const memorialDate = new Date('2026-04-05'); // 清明节
+if (today.toDateString() === memorialDate.toDateString()) {
+  mixPublicLib.GreyAllPages({ isGrey: true });
+}
+```
+
+### TypeScript 示例
+
+```typescript
+import type { GreyAllPagesType } from './paramsTypes';
+
+// 启用灰度模式
+const enableGrey: GreyAllPagesType = {
+  isGrey: true
+};
+mixPublicLib.GreyAllPages(enableGrey);
+
+// 禁用灰度模式
+const disableGrey: GreyAllPagesType = {
+  isGrey: false
+};
+mixPublicLib.GreyAllPages(disableGrey);
+```
+
+## 使用说明
+
+### 功能说明
+
+- **isGrey: true**: 应用所有页面内容转换为灰度显示
+- **isGrey: false**: 恢复正常的彩色显示
+- 影响整个应用的所有页面和组件
+
+### 平台差异
+
+- **Web端**: 通过CSS filter属性实现灰度效果
+- **APP端**: 调用原生方法设置全局灰度滤镜
+- **iOS/Android**: 原生实现，效果更佳且性能更好
+
+### 使用场景
+
+- 国家哀悼日的特殊显示模式
+- 应用维护或故障时的视觉提示
+- 用户自定义的主题模式
+- 特殊节日或纪念日的视觉效果
+- 辅助功能（色盲模式等）
+
+## 注意事项
+
+- **性能影响**: 
+  - Web端的CSS filter可能影响渲染性能
+  - APP端的原生实现通常性能更好
+  - 大量动画或复杂UI在灰度模式下可能有性能下降
+- **用户体验**: 
+  - 灰度模式会显著改变应用的视觉体验
+  - 建议提供明确的用户通知或说明
+  - 考虑提供用户手动切换的选项
+- **兼容性**: 
+  - 老版本浏览器可能不支持CSS filter
+  - 某些Android版本可能有灰度显示限制
+  - Web端的效果可能不如原生实现一致
+- **最佳实践**: 
+  - 在合适的时机启用灰度模式（如国家哀悼日）
+  - 提供清晰的用户引导和说明
+  - 考虑与其他视觉效果的冲突
+  - 测试不同设备上的显示效果
+- **恢复机制**: 
+  - 应用重启后可能需要重新设置状态
+  - 建议持久化用户的灰度模式偏好
+
+## 相关 API
+
+- [`SetTitle`](./050-SetTitle.md) - 设置页面标题
+- [`SetStatusBarBgColor`](./052-SetStatusBarBgColor.md) - 设置状态栏背景色
+- [`RefreshDialog`](./044-RefreshDialog.md) - 刷新页面

package/docs/api//351/241/265/351/235/242/350/267/263/350/275/254/072-ClosePop.md

@@ -0,0 +1,133 @@
+---
+date: 2026-03-06
+permalink: /pages/api-close-pop/
+categories: 
+  - API
+  - 页面控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# ClosePop - 关闭弹窗
+
+## 功能描述
+
+关闭当前显示的弹窗。用于程序化关闭各种类型的弹窗组件。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ClosePop(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 关闭当前弹窗
+mixPublicLib.ClosePop();
+
+// 在弹窗确认按钮点击后关闭弹窗
+document.getElementById('confirmBtn').addEventListener('click', () => {
+  // 执行确认操作
+  performConfirmAction();
+  // 关闭弹窗
+  mixPublicLib.ClosePop();
+});
+
+// 定时自动关闭弹窗
+setTimeout(() => {
+  mixPublicLib.ClosePop();
+}, 5000); // 5秒后自动关闭
+```
+
+### TypeScript 示例
+
+```typescript
+// 关闭当前弹窗
+mixPublicLib.ClosePop();
+
+// 在异步操作完成后关闭弹窗
+async function handlePopupAction() {
+  try {
+    await performAsyncOperation();
+    mixPublicLib.ClosePop();
+  } catch (error) {
+    console.error("操作失败:", error);
+  }
+}
+```
+
+## 使用说明
+
+### 功能说明
+
+- 关闭当前最上层的弹窗组件
+- 支持各种类型的弹窗（对话框、提示框、自定义弹窗等）
+- 如果没有弹窗显示，则无任何效果
+
+### 平台差异
+
+- **Web端**: 关闭通过mixPublicLib显示的弹窗组件
+- **APP端**: 调用原生方法关闭当前弹窗
+- **小程序**: 关闭小程序内的弹窗组件
+
+### 弹窗类型支持
+
+- **系统对话框**: alert、confirm、prompt等
+- **自定义弹窗**: 通过PopupShow等方法创建的弹窗
+- **加载提示**: ShowLoading创建的加载弹窗
+- **消息提示**: ShowMsg创建的消息弹窗
+
+### 使用场景
+
+- 用户点击确认/取消按钮后关闭弹窗
+- 异步操作完成后的自动关闭
+- 错误处理后的弹窗清理
+- 定时自动关闭提示信息
+- 页面切换时的弹窗清理
+
+## 注意事项
+
+- **作用范围**: 
+  - 只关闭通过mixPublicLib创建的弹窗
+  - 不影响原生HTML的modal或dialog元素
+  - 如果有多个弹窗，通常关闭最上层的一个
+- **调用时机**: 
+  - 可以在任何时机调用，无需等待特定条件
+  - 即使没有弹窗也不会报错
+- **用户体验**: 
+  - 避免频繁开关弹窗造成闪烁
+  - 确保用户有足够时间阅读弹窗内容
+  - 提供明确的关闭触发条件
+- **最佳实践**: 
+  - 在用户操作完成后立即关闭弹窗
+  - 结合具体的业务逻辑使用
+  - 考虑弹窗关闭后的后续操作
+  - 测试不同场景下的关闭效果
+- **兼容性**: 
+  - 所有平台都支持基本的关闭功能
+  - 某些特殊弹窗类型可能需要额外处理
+
+## 相关 API
+
+- [`PopupShow`](./006-PopupShow.md) - 显示弹窗
+- [`PopupClose`](./007-PopupClose.md) - 关闭弹窗（另一种方式）
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框
+- [`ShowLoading`](./085-ShowLoading.md) - 显示加载提示
+- [`ShowMsg`](./087-ShowMsg.md) - 显示消息提示

package/docs/api//351/241/265/351/235/242/350/267/263/350/275/254/108-StayTime.md

@@ -0,0 +1,139 @@
+---
+date: 2026-03-06
+permalink: /pages/api-stay-time/
+categories: 
+  - API
+  - 数据统计
+tags: []
+author: { name: AI Assistant }
+---
+
+# StayTime - 页面停留时间
+
+## 功能描述
+
+记录用户在当前页面的停留时间。用于统计用户行为和页面访问时长。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+StayTime(option: { 
+  pageName: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| pageName | string | 是 | 页面名称标识 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 记录首页停留时间
+mixPublicLib.StayTime({ 
+  pageName: "home" 
+});
+
+// 记录商品详情页停留时间
+mixPublicLib.StayTime({ 
+  pageName: "product_detail" 
+});
+
+// 在页面加载时开始记录
+document.addEventListener('DOMContentLoaded', () => {
+  const currentPage = getCurrentPageName();
+  mixPublicLib.StayTime({ pageName: currentPage });
+});
+
+// 结合页面路由使用
+function trackPageView(pageName) {
+  // 记录页面访问
+  mixPublicLib.StayTime({ pageName: pageName });
+  // 其他分析逻辑
+  sendPageViewEvent(pageName);
+}
+```
+
+### TypeScript 示例
+
+```typescript
+import type { StayTimeType } from './paramsTypes';
+
+// 记录页面停留时间
+const stayOptions: StayTimeType = {
+  pageName: "user_profile"
+};
+mixPublicLib.StayTime(stayOptions);
+```
+
+## 使用说明
+
+### 功能说明
+
+- 自动开始计时从调用时刻起
+- 记录用户在当前页面的总停留时间
+- 通常在页面卸载时自动上报数据
+- 支持多个页面的独立计时
+
+### 平台差异
+
+- **Web端**: 使用Performance API或自定义计时器
+- **APP端**: 调用原生统计SDK
+- **小程序**: 使用小程序的统计API
+
+### 数据收集
+
+- **开始时间**: 调用 `StayTime` 方法的时间点
+- **结束时间**: 页面卸载或应用切换的时间点
+- **停留时长**: 结束时间减去开始时间
+- **页面标识**: 通过pageName参数区分不同页面
+
+### 使用场景
+
+- 用户行为分析
+- 页面内容优化
+- 转化率分析
+- 用户体验改进
+- A/B测试效果评估
+
+## 注意事项
+
+- **调用时机**: 
+  - 应该在页面完全加载后调用
+  - 避免在页面切换过程中重复调用
+  - 确保pageName参数的一致性
+- **隐私考虑**: 
+  - 遵守相关的隐私政策和法规
+  - 提供用户数据收集的透明度
+  - 支持用户选择退出数据收集
+- **最佳实践**: 
+  - 使用有意义的pageName标识
+  - 统一页面命名规范
+  - 测试不同场景下的计时准确性
+  - 结合其他用户行为数据使用
+- **兼容性**: 
+  - 不同平台的计时精度可能不同
+  - 某些浏览器可能限制后台计时
+  - 老版本系统可能有兼容性问题
+- **性能影响**: 
+  - 计时功能对性能影响很小
+  - 避免频繁调用此方法
+  - 考虑数据上报的网络开销
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`OnlineService`](./104-OnlineService.md) - 在线客服
+- [`GetAppVersion`](./069-GetAppVersion.md) - 获取应用版本