Let users copy images next to download on shared attachment cards, preview toolbars, and list cells so they can paste into chat or docs without saving files first. Co-authored-by: Cursor <cursoragent@cursor.com>
152 lines
4.8 KiB
TypeScript
152 lines
4.8 KiB
TypeScript
/**
|
||
* 复制文本到剪贴板。
|
||
* 小程序 web-view / H5 iframe 常被 Permissions Policy 拦截 Clipboard API,
|
||
* 需回退到 execCommand,必要时再交给壳页复制。
|
||
* 另提供图片 Blob / 附件图片写入系统剪贴板(ClipboardItem)。
|
||
*/
|
||
import { MP_WEBVIEW_COPY_TEXT } from '@/utils/mp-webview'
|
||
|
||
export type AttachmentClipboardItem = {
|
||
fileUrl?: string
|
||
fileName?: string
|
||
}
|
||
|
||
function fallbackExecCommandCopy(text: string): boolean {
|
||
try {
|
||
const textarea = document.createElement('textarea')
|
||
textarea.value = text
|
||
textarea.setAttribute('readonly', '')
|
||
textarea.style.position = 'fixed'
|
||
textarea.style.top = '0'
|
||
textarea.style.left = '0'
|
||
textarea.style.width = '1px'
|
||
textarea.style.height = '1px'
|
||
textarea.style.padding = '0'
|
||
textarea.style.border = 'none'
|
||
textarea.style.outline = 'none'
|
||
textarea.style.boxShadow = 'none'
|
||
textarea.style.background = 'transparent'
|
||
textarea.style.opacity = '0'
|
||
document.body.appendChild(textarea)
|
||
textarea.focus()
|
||
textarea.select()
|
||
textarea.setSelectionRange(0, textarea.value.length)
|
||
const ok = document.execCommand('copy')
|
||
document.body.removeChild(textarea)
|
||
return ok
|
||
} catch {
|
||
return false
|
||
}
|
||
}
|
||
|
||
/** H5:内嵌 iframe 被策略拦截时,交给壳页(父窗口)执行复制 */
|
||
function tryCopyViaMpWebviewHost(text: string): boolean {
|
||
if (typeof window === 'undefined') return false
|
||
if (!window.parent || window.parent === window) return false
|
||
try {
|
||
window.parent.postMessage({ type: MP_WEBVIEW_COPY_TEXT, text }, '*')
|
||
return true
|
||
} catch {
|
||
return false
|
||
}
|
||
}
|
||
|
||
export async function copyTextToClipboard(text: string): Promise<boolean> {
|
||
const value = String(text ?? '')
|
||
if (!value) return false
|
||
|
||
try {
|
||
if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
|
||
await navigator.clipboard.writeText(value)
|
||
return true
|
||
}
|
||
} catch {
|
||
/* Permissions Policy / insecure context → fallback */
|
||
}
|
||
|
||
if (typeof document !== 'undefined' && fallbackExecCommandCopy(value)) {
|
||
return true
|
||
}
|
||
|
||
return tryCopyViaMpWebviewHost(value)
|
||
}
|
||
|
||
/** 与 download-attachment 图片判定对齐,避免测试静态拉入整条 API 依赖链 */
|
||
function isImageAttachment(file: AttachmentClipboardItem): boolean {
|
||
const name = String(file.fileName || '').toLowerCase()
|
||
const url = String(file.fileUrl || '')
|
||
.split('?')[0]
|
||
.toLowerCase()
|
||
return (
|
||
/\.(jpg|jpeg|png|gif|bmp|webp|svg)$/i.test(name) ||
|
||
/\.(jpg|jpeg|png|gif|bmp|webp|svg)$/i.test(url)
|
||
)
|
||
}
|
||
|
||
/** 已是 PNG 则原样返回;否则经 canvas 转为 image/png。 */
|
||
export async function ensurePngBlob(blob: Blob): Promise<Blob> {
|
||
if (blob.type === 'image/png') return blob
|
||
|
||
if (typeof createImageBitmap === 'function' && typeof document !== 'undefined') {
|
||
const bitmap = await createImageBitmap(blob)
|
||
try {
|
||
const canvas = document.createElement('canvas')
|
||
canvas.width = bitmap.width
|
||
canvas.height = bitmap.height
|
||
const ctx = canvas.getContext('2d')
|
||
if (!ctx) throw new Error('canvas 2d unavailable')
|
||
ctx.drawImage(bitmap, 0, 0)
|
||
const png = await new Promise<Blob>((resolve, reject) => {
|
||
canvas.toBlob((b) => (b ? resolve(b) : reject(new Error('toBlob failed'))), 'image/png')
|
||
})
|
||
return png
|
||
} finally {
|
||
bitmap.close?.()
|
||
}
|
||
}
|
||
|
||
// 无 canvas 环境时仍尝试按原类型写入(部分浏览器接受 image/jpeg)
|
||
return blob
|
||
}
|
||
|
||
/** 将图片 Blob 写入系统剪贴板;失败返回 false。 */
|
||
export async function copyImageBlobToClipboard(blob: Blob): Promise<boolean> {
|
||
if (!blob || blob.size <= 0) return false
|
||
try {
|
||
if (typeof navigator === 'undefined' || !navigator.clipboard?.write) return false
|
||
if (typeof ClipboardItem === 'undefined') return false
|
||
const png = await ensurePngBlob(blob)
|
||
const type = png.type || 'image/png'
|
||
await navigator.clipboard.write([new ClipboardItem({ [type]: png })])
|
||
return true
|
||
} catch {
|
||
return false
|
||
}
|
||
}
|
||
|
||
export type CopyAttachmentImageOptions = {
|
||
fullFileUrl?: (url: string) => string
|
||
/** 测试可注入;默认走预签名下载 Blob */
|
||
fetchBlob?: (
|
||
file: AttachmentClipboardItem,
|
||
options?: { fullFileUrl?: (url: string) => string }
|
||
) => Promise<Blob>
|
||
}
|
||
|
||
/** 仅图片附件:拉取 Blob 后写入剪贴板;非图片返回 false。 */
|
||
export async function copyAttachmentImageToClipboard(
|
||
file: AttachmentClipboardItem,
|
||
options?: CopyAttachmentImageOptions
|
||
): Promise<boolean> {
|
||
if (!isImageAttachment(file)) return false
|
||
try {
|
||
const fetchBlob =
|
||
options?.fetchBlob ||
|
||
(await import('@/utils/download-attachment')).fetchAttachmentBlob
|
||
const blob = await fetchBlob(file, { fullFileUrl: options?.fullFileUrl })
|
||
return await copyImageBlobToClipboard(blob)
|
||
} catch {
|
||
return false
|
||
}
|
||
}
|