# 剪贴板 clipboard
手机
# 接口声明
{ "name": "system.clipboard" }
1
# 导入模块
import clipboard from '@system.clipboard' 或 const clipboard = require('@system.clipboard')
1
# 接口定义
# clipboard.set(OBJECT)
修改剪贴板内容
# 权限要求
写入剪贴板(注:各厂商权限要求可能不同,vivo 侧要求写入剪贴板权限)
# 参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | String | 是 | 需要放到剪切板的内容 |
| success | Function | 否 | 成功回调 |
| fail | Function | 否 | 失败回调 |
| complete | Function | 否 | 执行结束后的回调 |
# fail 返回错误代码
| 错误码 | 说明 |
|---|---|
| 201 | 用户拒绝,获取写入剪贴板权限失败 |
# 示例:
clipboard.set({
text: 'text',
success: function(data) {
console.log(`handling success`)
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`)
}
})
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# clipboard.get(OBJECT)
读取剪贴板内容
# 权限要求
访问剪贴板(要求访问剪贴板权限)
# 参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 成功回调 |
| fail | Function | 否 | 失败回调 |
| complete | Function | 否 | 执行结束后的回调 |
# success 返回值:
| 参数名 | 类型 | 说明 |
|---|---|---|
| text | String | 剪切板内容 |
# fail 返回错误代码
| 错误码 | 说明 |
|---|---|
| 201 | 用户拒绝,获取访问剪贴板权限失败 |
# 示例:
clipboard.get({
success: function(data) {
console.log(`handling success: ${data.text}`)
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`)
}
})
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
←
→
