1

2026-09-24 16:25:22 +08:00
commit 7428184f01
1198 changed files with 314515 additions and 0 deletions
@@ -0,0 +1,90 @@
+# x-clipboard-s
+
+### 开发文档
+[TMUI4.0文档](https://xui.tmui.design/)
+[TMUI4.0组件库](https://ext.dcloud.net.cn/plugin?id=16369)
+
+### 介绍
+这是tmui4.0|XUI的原生插件附赠插件，提供了跨平台的剪贴板操作功能。支持在Android、iOS、Web和小程序平台上进行文本内容的复制和获取操作。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+
+```json
+"requestPermissions": [
+  {
+    "name": "ohos.permission.READ_PASTEBOARD",
+    "reason": "$string:permission_read_pasteboard"
+  }
+]
+```
+
+### 注意事项
+- Web平台：新版浏览器会自动请求剪贴板权限
+- Android平台：使用系统ClipboardManager服务实现
+- iOS平台：使用UIPasteboard实现
+- 小程序：使用平台原生API实现
+
+### API接口
+
+#### setClipboardData
+`setClipboardData(data: string): Promise<boolean>`
+设置剪贴板内容
+
+**参数说明：**
+- data：要设置的文本内容
+
+**返回值：**
+- `Promise<boolean>`：操作成功返回true，失败返回false
+
+#### getClipboardData()
+`getClipboardData(): Promise<string>`
+获取剪贴板内容
+
+**返回值：**
+- `Promise<string>`：成功返回剪贴板文本内容，失败返回错误信息
+
+### 使用示例
+
+```ts
+import { setClipboardData, getClipboardData } from "@/uni_modules/x-clipboard-s"
+
+// 设置剪贴板内容
+const setText = () => {
+    setClipboardData("要复制的文本").then(ok => {
+        if (ok) {
+            uni.showToast({ title: "复制成功", icon: "success" })
+        }
+    }).catch(err => {
+        uni.showToast({ title: "复制失败", icon: "error" })
+    })
+}
+
+// 获取剪贴板内容
+const getText = () => {
+    getClipboardData().then((text: string) => {
+        uni.showToast({
+            title: text,
+            icon: "none"
+        })
+    }).catch(err => {
+        uni.showToast({
+            title: "获取剪贴板内容失败",
+            icon: "error"
+        })
+    })
+}
+```
+
+### 常见问题
+1. Web端获取剪贴板内容失败？
+   - 检查浏览器是否授予了剪贴板访问权限
+   - 确保在HTTPS环境下运行
+
+2. Android/iOS端操作失败？
+   - 检查应用是否具有剪贴板权限
+   - 确保传入的是文本内容