mix-public 1.2.0 → 1.2.2

package/docs/api//351/200/232/347/237/245/346/217/220/351/206/222/061-GetClipboardContent.md

@@ -0,0 +1,117 @@
+---
+date: 2026-03-06
+permalink: /pages/api-get-clipboard-content/
+categories: 
+  - API
+  - 设备信息
+tags: []
+author: { name: AI Assistant }
+---
+
+# GetClipboardContent - 获取剪贴板内容
+
+## 功能描述
+
+获取设备剪贴板中的文本内容。用于读取用户复制的文本数据。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+GetClipboardContent(): string
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+string - 返回剪贴板中的文本内容，如果剪贴板为空则返回空字符串
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 获取剪贴板内容
+const clipboardText = mixPublicLib.GetClipboardContent();
+console.log("剪贴板内容:", clipboardText);
+
+// 检查剪贴板是否有内容
+if (clipboardText.trim()) {
+  console.log("剪贴板包含文本:", clipboardText);
+} else {
+  console.log("剪贴板为空");
+}
+
+// 自动填充表单字段
+document.getElementById('inputField').value = clipboardText;
+```
+
+### TypeScript 示例
+
+```typescript
+// 获取剪贴板内容
+const clipboardText: string = mixPublicLib.GetClipboardContent();
+console.log(`剪贴板内容: ${clipboardText}`);
+
+// 类型安全的处理
+if (typeof clipboardText === 'string' && clipboardText.length > 0) {
+  console.log("剪贴板有内容");
+}
+```
+
+## 使用说明
+
+### 平台差异
+
+- **APP端**: 调用原生剪贴板API获取文本内容
+- **Web端**: 使用现代浏览器的Clipboard API或传统的document.execCommand
+- **iOS/Android**: 原生实现，支持标准文本格式
+
+### 内容类型
+
+- **支持格式**: 纯文本内容
+- **不支持**: 富文本、图片、文件等二进制数据
+- **编码**: UTF-8编码的文本内容
+
+### 使用场景
+
+- 自动填充表单字段
+- 读取用户复制的验证码
+- 处理复制的URL或链接
+- 文本编辑器的粘贴功能
+- 数据导入功能
+
+## 注意事项
+
+- **权限要求**: 
+  - Web端需要HTTPS环境和用户交互（如点击事件）
+  - APP端通常需要用户授权剪贴板访问权限
+  - iOS 14+对剪贴板访问有更严格的限制
+- **隐私考虑**: 
+  - 剪贴板可能包含敏感信息
+  - 建议仅在必要时读取剪贴板
+  - 不要存储或传输剪贴板内容
+- **兼容性**: 
+  - 老版本浏览器可能不支持现代Clipboard API
+  - 某些平台可能限制后台应用访问剪贴板
+- **错误处理**: 
+  - 剪贴板为空时返回空字符串
+  - 权限拒绝时可能抛出异常
+  - 建议使用try-catch包装调用
+- **用户体验**: 
+  - 避免频繁读取剪贴板
+  - 在用户明确操作后读取（如点击按钮）
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`ShowMsg`](./087-ShowMsg.md) - 显示消息提示
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框

package/docs/api//351/200/232/347/237/245/346/217/220/351/206/222/067-ScheduleReminder.md

@@ -0,0 +1,138 @@
+---
+date: 2026-03-06
+permalink: /pages/api-schedule-reminder/
+categories: 
+  - API
+  - 系统功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ScheduleReminder - 设置日程提醒
+
+## 功能描述
+
+设置系统日历的日程提醒。用于在指定时间创建日历事件并设置提醒。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ScheduleReminder(option: ScheduleReminderType): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| option | ScheduleReminderType | 是 | 日程提醒配置对象 | {} |
+
+#### ScheduleReminderType 接口定义
+
+```typescript
+interface ScheduleReminderType {
+  Title: string;
+  StartDate: string;
+  Notes?: string;
+  Alarm?: number;
+}
+```
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 设置基本日程提醒
+mixPublicLib.ScheduleReminder({
+  Title: "团队会议",
+  StartDate: "2026-03-10 14:00:00",
+});
+
+// 设置完整的日程提醒
+mixPublicLib.ScheduleReminder({
+  Title: "项目截止日期",
+  StartDate: "2026-03-15 09:00:00",
+  Notes: "请准备项目汇报材料",
+  Alarm: 600
+});
+```
+
+### TypeScript 示例
+
+``typescript
+import type { ScheduleReminderType } from './paramsTypes';
+
+const meetingReminder: ScheduleReminderType = {
+  Title: "团队会议",
+  StartDate: "2026-03-10 14:00:00",
+  Notes: "讨论Q1项目进展"
+};
+
+mixPublicLib.ScheduleReminder(meetingReminder);
+```
+
+## 使用说明
+
+### 参数说明
+
+- **Title**: 日程事件的标题（必填）
+- **StartDate**: 日程开始时间，格式：`YYYY-MM-DD HH:mm:ss`（必填）
+- **Notes**: 日程备注信息（可选）
+- **Alarm**: 提前时间（m）
+
+### 时间格式要求
+
+- 必须使用 `YYYY-MM-DD HH:mm:ss` 格式
+- 时间必须是有效的未来时间
+- 开始时间必须早于结束时间
+
+### 平台差异
+
+- **iOS**: 调用系统日历API创建事件
+- **Android**: 调用系统日历API创建事件
+- **Web端**: 可能不支持或提供模拟功能
+
+### 使用场景
+
+- 会议预约提醒
+- 任务截止日期提醒
+- 重要事件日程安排
+- 个人日程管理
+- 项目里程碑提醒
+
+## 注意事项
+
+- **权限要求**: 
+  - 需要用户授权日历写入权限
+  - iOS需要在Info.plist中配置日历权限描述
+  - Android需要在Manifest中声明日历权限
+- **平台限制**: 
+  - Web端通常不支持系统日历操作
+  - 某些设备可能禁用了日历写入功能
+- **用户体验**: 
+  - 系统会弹出日历应用确认对话框
+  - 用户可以选择接受或拒绝日程添加
+  - 建议在添加前验证时间格式的有效性
+- **最佳实践**: 
+  - 提供明确的日程标题和描述
+  - 设置合理的提醒时间
+  - 避免频繁创建日程事件
+  - 在用户明确操作后调用此功能
+- **错误处理**: 
+  - 权限拒绝时可能无响应或抛出异常
+  - 无效时间格式可能导致创建失败
+  - 建议提供手动添加日程的替代方案
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框
+- [`SettingApns`](./068-SettingApns.md) - 推送设置

package/docs/api//351/200/232/347/237/245/346/217/220/351/206/222/089-FloatingWindowData.md

@@ -0,0 +1,168 @@
+---
+date: 2026-03-06
+permalink: /pages/api-floating-window-data/
+categories: 
+  - API
+  - 用户界面
+tags: []
+author: { name: AI Assistant }
+---
+
+# FloatingWindowData - 悬浮窗数据
+
+## 功能描述
+
+设置或获取悬浮窗的数据。用于管理应用中的悬浮窗口内容和状态。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+FloatingWindowData(option: FloatingWindowDataType): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| option | FloatingWindowDataType | 是 | 悬浮窗数据配置对象 | {} |
+
+#### FloatingWindowDataType 接口定义
+
+```typescript
+interface FloatingWindowDataType {
+  Url: string;
+  data?: any;
+}
+```
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 显示悬浮窗
+mixPublicLib.FloatingWindowData({
+  Url: "show",
+  data: {
+    title: "通知",
+    content: "您有新的消息",
+    icon: "message-icon.png"
+  }
+});
+
+// 隐藏悬浮窗
+mixPublicLib.FloatingWindowData({
+  Url: "hide"
+});
+
+// 更新悬浮窗内容
+mixPublicLib.FloatingWindowData({
+  Url: "update",
+  data: {
+    content: "消息已读",
+    unreadCount: 0
+  }
+});
+
+// 设置悬浮窗位置
+mixPublicLib.FloatingWindowData({
+  Url: "setPosition",
+  data: {
+    x: 100,
+    y: 200
+  }
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { FloatingWindowDataType } from './paramsTypes';
+
+// 显示悬浮窗
+const showWindow: FloatingWindowDataType = {
+  Url: "show",
+  data: {
+    title: "通知",
+    content: "您有新的消息"
+  }
+};
+mixPublicLib.FloatingWindowData(showWindow);
+
+// 隐藏悬浮窗
+const hideWindow: FloatingWindowDataType = {
+  Url: "hide"
+};
+mixPublicLib.FloatingWindowData(hideWindow);
+```
+
+## 使用说明
+
+### 支持的操作
+
+- **show**: 显示悬浮窗
+- **hide**: 隐藏悬浮窗  
+- **update**: 更新悬浮窗内容
+- **setPosition**: 设置悬浮窗位置
+- **getData**: 获取悬浮窗当前数据（可能通过其他方式返回）
+
+### 数据结构
+
+- **data**: 根据Url类型传递不同的数据结构
+- **title**: 悬浮窗标题（显示时）
+- **content**: 悬浮窗内容（显示时）
+- **icon**: 悬浮窗图标（显示时）
+- **position**: 悬浮窗位置坐标（设置位置时）
+
+### 平台差异
+
+- **APP端**: 调用原生悬浮窗API，支持系统级悬浮窗
+- **Web端**: 可能使用固定定位的div元素模拟悬浮窗
+- **小程序**: 可能不支持或提供有限的悬浮窗功能
+
+### 使用场景
+
+- 实时消息通知
+- 在线客服入口
+- 应用内快捷操作
+- 系统状态监控
+- 用户行为引导
+
+## 注意事项
+
+- **权限要求**: 
+  - Android需要SYSTEM_ALERT_WINDOW权限
+  - iOS对悬浮窗有严格限制
+  - Web端受浏览器安全策略限制
+- **用户体验**: 
+  - 避免悬浮窗遮挡重要内容
+  - 提供关闭悬浮窗的选项
+  - 考虑不同屏幕尺寸的适配
+- **最佳实践**: 
+  - 悬浮窗内容应该简洁明了
+  - 提供明确的交互方式
+  - 避免频繁显示和隐藏悬浮窗
+  - 测试不同设备上的显示效果
+- **兼容性**: 
+  - 不同平台的悬浮窗实现差异很大
+  - 某些Android版本可能限制悬浮窗功能
+  - Web端的悬浮窗可能被浏览器阻止
+- **性能考虑**: 
+  - 悬浮窗可能影响应用性能
+  - 避免在悬浮窗中执行复杂操作
+  - 考虑电池消耗的影响
+
+## 相关 API
+
+- [`ShowMsg`](./087-ShowMsg.md) - 显示消息提示
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框
+- [`PopupShow`](./006-PopupShow.md) - 显示弹窗
+- [`ClosePop`](./072-ClosePop.md) - 关闭弹窗

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

@@ -0,0 +1,114 @@
+---
+date: 2026-03-04
+permalink: /pages/api-goto/
+categories: 
+  - API
+  - 页面跳转
+tags: []
+author: { name: AI Assistant }
+---
+
+# Goto - 跳转页面
+
+## 功能描述
+
+跳转到指定页面，支持内部页面、外部网页和小程序跳转。根据 URL 类型自动选择跳转方式。
+
+## 调用类型
+
+异步返回类
+
+## 方法说明
+
+```typescript
+Goto(option: { 
+  Url: string; 
+  Params?: object; 
+  OutSide?: boolean 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Url | string | 是 | 跳转目标页面路径或 URL | - |
+| Params | object | 否 | 传递的参数对象 | {} |
+| OutSide | boolean | 否 | 是否在浏览器中打开（仅 http URL 有效） | false |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 跳转内部页面
+mixPublicLib.Goto({ 
+  Url: "user-login",
+  Params: { from: "home" }
+});
+
+// 跳转外部网页（在当前应用内打开）
+mixPublicLib.Goto({ 
+  Url: "https://www.example.com"
+});
+
+// 跳转外部网页（在浏览器中打开）
+mixPublicLib.Goto({ 
+  Url: "https://www.example.com",
+  OutSide: true
+});
+
+// 跳转小程序
+mixPublicLib.Goto({ 
+  Url: "MiniApp?MiniAppId=appid&OnlineUrl=onlineurl&JumpUrl=miniapppagename"
+});
+```
+
+### TypeScript 示例
+
+```
+import type { GotoType } from './paramsTypes';
+
+const options: GotoType = {
+  Url: "user-login",
+  Params: { userId: "12345" }
+};
+
+mixPublicLib.Goto(options);
+```
+
+## 使用说明
+
+### URL 类型识别
+
+1. **http/https 开头**: 跳转外部网页
+   - `OutSide: false`（默认）：在应用内打开
+   - `OutSide: true`：在系统浏览器中打开
+
+2. **MiniApp 开头**: 跳转小程序
+   - 需要包含 MiniAppId、OnlineUrl、JumpUrl 参数
+
+3. **其他**: 跳转内部页面
+   - 自动添加 `.html` 后缀
+   - 参数会自动存储到 cookies
+
+### 参数传递
+
+- 参数长度 > 0 时，会自动存储到 `mixAPPPageParams` cookie 中
+- 目标页面可通过 `GetCookieInfo("mixAPPPageParams")` 获取参数
+
+## 注意事项
+
+- 确保 URL 格式正确
+- 小程序跳转需要正确的配置参数
+- Web 端和 APP 端的跳转行为可能有所不同
+
+## 相关 API
+
+- [`GotoInside`](./002-GotoInside.md) - 跳转内部页面
+- [`GoBack`](./008-GoBack.md) - 返回上一页
+- [`ReturnHomePage`](./009-ReturnHomePage.md) - 返回首页

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

@@ -0,0 +1,80 @@
+---
+date: 2026-03-06
+permalink: /pages/api-goto-inside/
+categories: 
+  - API
+  - 页面跳转
+tags: []
+author: { name: AI Assistant }
+---
+
+# GotoInside - 跳转内部页面
+
+## 功能描述
+
+跳转内部页面（内部方法，请使用Goto方法）。此方法是内部使用的跳转方法，建议直接使用Goto方法。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+GotoInside(option: { 
+  Url: string; 
+}, Inside: boolean = false): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Url | string | 是 | 页面路径 | "" |
+| Inside | boolean | 否 | 内部调用标识，必须为true才能正常执行 | false |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```
+// 内部方法，不建议直接调用
+// mixPublicLib.GotoInside({ Url: "user-login" }, true);
+```
+
+### TypeScript 示例
+
+```
+import type { GotoInsideType } from './paramsTypes';
+
+// 内部方法，不建议直接调用
+// const options: GotoInsideType = { Url: "user-login" };
+// mixPublicLib.GotoInside(options, true);
+```
+
+## 使用说明
+
+### 内部方法说明
+
+- 此方法为内部调用方法，主要用于Goto方法的内部实现
+- 如果直接调用且Inside参数不为true，会抛出错误："For internal invocation only!"
+- 建议使用Goto方法替代此方法
+
+### URL 处理
+
+- 如果URL以http开头，会直接跳转到该URL
+- 其他情况会自动添加 `.html` 后缀进行跳转
+
+## 注意事项
+
+- 此方法仅供内部使用，不建议在业务代码中直接调用
+- 必须传入Inside参数为true才能正常执行
+- Web端和APP端的跳转行为一致
+
+## 相关 API
+
+- [`Goto`](./001-Goto.md) - 跳转页面（推荐使用）

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

@@ -0,0 +1,70 @@
+---
+date: 2026-03-06
+permalink: /pages/api-goto-main/
+categories: 
+  - API
+  - 页面跳转
+tags: []
+author: { name: AI Assistant }
+---
+
+# GotoMain - 跳转首页
+
+## 功能描述
+
+跳转至配置的首页（下标为0的首页）。仅用于登录页面，跳转页面为配置下标为0的首页。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+GotoMain(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 跳转至首页
+mixPublicLib.GotoMain();
+```
+
+### TypeScript 示例
+
+```typescript
+// 跳转至首页
+mixPublicLib.GotoMain();
+```
+
+## 使用说明
+
+### 使用场景
+
+- 主要用于登录成功后的跳转
+- 会跳转到配置中下标为0的首页页面
+- Web端通过Goto方法实现跳转，APP端通过原生方法实现
+
+## 注意事项
+
+- 此方法仅适用于登录页面使用
+- 需要确保项目配置中存在首页配置
+- Web端和APP端的行为一致
+
+## 相关 API
+
+- [`Goto`](./001-Goto.md) - 跳转页面
+- [`ReturnHomePage`](./009-ReturnHomePage.md) - 返回首页（可指定索引）