@capacitor/clipboard
该剪贴板 API 支持与系统剪贴板之间的复制和粘贴操作。
安装
npm install @capacitor/clipboard
npx cap sync
示例
import { Clipboard } from '@capacitor/clipboard';
const writeToClipboard = async () => {
await Clipboard.write({
string: 'Hello World!',
});
};
const checkClipboard = async () => {
const { type, value } = await Clipboard.read();
console.log(`从剪贴板获取到 ${type} 类型数据: ${value}`);
};
API
write(...)
write(options: WriteOptions) => Promise<void>
向剪贴板写入值("复制"操作)
参数 | 类型 |
---|---|
options |
|
起始版本: 1.0.0
read()
read() => Promise<ReadResult>
从剪贴板读取值("粘贴"操作)
返回值:
Promise<ReadResult>
起始版本: 1.0.0
Interfaces
WriteOptions
表示要写入剪贴板的数据。
属性 | 类型 | 描述 | 起始版本 |
---|---|---|---|
string | string | 要复制的文本值 | 1.0.0 |
image | string | 要复制的 Data URL 格式图片 | 1.0.0 |
url | string | 要复制的 URL 字符串 | 1.0.0 |
label | string | 伴随复制数据的用户可见标签(仅限 Android) | 1.0.0 |
ReadResult
表示从剪贴板读取的数据。
属性 | 类型 | 描述 | 起始版本 |
---|---|---|---|
value | string | 从剪贴板读取的数据 | 1.0.0 |
type | string | 剪贴板中数据的类型 | 1.0.0 |