useClipboard
@astryxdesign/core v0.7.1 · useClipboard
参数
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
options | UseClipboardOptions | {} | 配置对象,可以不传。 |
options.announce | string | — | 复制成功后念给读屏的句子。只换 aria-label 时读屏经常不念,所以这里传一句本地化的确认(例如「已复制」)。不传就不播报。 |
options.resetAfterMs | number | 2000 | 复制成功后 isCopied 保持为 true 的毫秒数。 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
copy | (text: string) => Promise<boolean> | 把 text 写进剪贴板。成功时 isCopied 变为 true、播报配置的句子、重置定时器,并返回 true。写入被拒绝时什么都不改,返回 false。 |
isCopied | Ref<boolean> | 最近一次复制成功后的 resetAfterMs 内为 true,之后归位。复制成功的提示(例如复制图标换成对勾)看它即可。 |