更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

  • 首个版本，功能可用

平台兼容性

pk-clipboard 剪贴板套件

纯 JS 剪贴板读写 + 复制历史记录，零原生依赖，全端可用（App / 小程序 / H5）。

为什么做它

竞品剪贴板插件普遍只有 get/set 两个 API；「复制历史」「内容类型识别」「JSON 智能还原」全都要自己写。pk-clipboard 内置环形历史（默认 50 条）、自动去重、JSON 往返还原、URL/邮箱/手机号/验证码类型识别。

快速上手

import clip from '@/uni_modules/pk-clipboard/js_sdk/index.js';

await clip.copy('要复制的内容');
const r = await clip.paste();
console.log(r.text, r.kind);   // '要复制的内容' 'text'

全部方法

方法 说明 返回
init({ maxHistory }) 初始化，设定历史容量（默认 50） { ok, maxHistory }
copy(text, opts) 复制文本。opts: { maxLen, _mock } { ok, chars, historyAction }
copyJSON(obj, opts) 序列化 JSON（2 空格缩进）后复制 同 copy
paste(opts) 读取剪贴板，JSON 自动还原 { ok, text, isJSON, parsed, kind }
history({ limit, digest }) 复制历史（新→旧），digest 为摘要截断长度 [{ index, at, chars, preview }]
restore(index, opts) 把历史第 index 条重新复制 同 copy
clearHistory() 清空历史 { ok, removed }
isAvailable() 当前环境是否支持剪贴板 boolean
selfCheck(opts) 写入→读回→比对 { ok, stage, match }

kind 类型识别：url / email / phone / otp / token? / text。

特性

  • 环形历史：连续复制相同内容只刷新时间戳（dup），超容量自动淘汰最旧并在 push 时返回 evicted
  • JSON 智能往返：copyJSON 写入 → paste 读出 isJSON:true + parsed 对象；非法 JSON 原样返回不误判
  • 安全上限：默认 2MB 文本上限（E-CB-03），超限快速失败

示例工程

example/ 为完整可跑工程，8 个演示卡片覆盖全部方法。在线文档：https://plugins.cnajiu.cn/public/pk-clipboard.html

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件不采集任何数据

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。