在此页

• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

copy event fires when the user initiates a copy action through the browser's user interface.

冒泡	Yes
可取消	Yes
接口	ClipboardEvent
事件处理程序特性	oncopy

The event's default action is to copy the selection (if any) to the clipboard.

A handler for this event can 修改 the clipboard contents by calling setData(format, data) on the event's ClipboardEvent.clipboardData property, and cancelling the event's default action using event.preventDefault() .

However, the handler cannot read the clipboard data.

It's possible to construct and dispatch a synthetic copy event, but this will not affect the system clipboard.

范例

实时范例

HTML

<div class="source" contenteditable="true">Try copying text from this box...</div>
<div class="target" contenteditable="true">...and pasting it into this one</div>
					

CSS

div.source, div.target {
    border: 1px solid gray;
    margin: .5rem;
    padding: .5rem;
    height: 1rem;
    background-color: #e9eef1;
}
					

JS

const source = document.querySelector('div.source');
source.addEventListener('copy', (event) => {
    const selection = document.getSelection();
    event.clipboardData.setData('text/plain', selection.toString().toUpperCase());
    event.preventDefault();
});
					

结果

规范

规范	状态
Clipboard API and events	工作草案

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
copy event	Chrome 58	Edge ≤18	Firefox Yes	IE Yes	Opera 45	Safari Yes	WebView Android 58	Chrome Android 58	Firefox Android Yes	Opera Android 43	Safari iOS Yes	Samsung Internet Android 7.0
clipboardData	Chrome 58	Edge ≤18	Firefox 22	IE No	Opera 45	Safari Yes	WebView Android 58	Chrome Android 58	Firefox Android 22	Opera Android 43	Safari iOS Yes	Samsung Internet Android 7.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

• 相关事件： cut , paste
• 此事件在 Document 目标： copy
• 此事件在 Window 目标： copy

元数据

• 最后修改： Feb 11, 2020

相关话题

1. 元素
2. 特性

   1. accessKey
   2. 属性
   3. childElementCount
   4. children
   5. classList
   6. className
   7. clientHeight
   8. clientLeft
   9. clientTop
   10. clientWidth
   11. currentStyle
   12. firstElementChild
   13. id
   14. innerHTML
   15. lastElementChild
   16. localName
   17. 名称
   18. namespaceURI
   19. nextElementSibling
   20. onfullscreenchange
   21. onfullscreenerror
   22. openOrClosedShadowRoot
   23. outerHTML
   24. part
   25. prefix
   26. previousElementSibling
   27. runtimeStyle
   28. scrollHeight
   29. scrollLeft
   30. scrollLeftMax
   31. scrollTop
   32. scrollTopMax
   33. scrollWidth
   34. shadowRoot
   35. slot
   36. tabStop
   37. tagName
3. 方法

   1. after()
   2. animate()
   3. append()
   4. attachShadow()
   5. before()
   6. closest()
   7. computedStyleMap()
   8. createShadowRoot()
   9. getAnimations()
   10. getAttribute()
   11. getAttributeNames()
   12. getAttributeNode()
   13. getAttributeNodeNS()
   14. getAttributeNS()
   15. getBoundingClientRect()
   16. getClientRects()
   17. getElementsByClassName()
   18. getElementsByTagName()
   19. getElementsByTagNameNS()
   20. hasAttribute()
   21. hasAttributeNS()
   22. hasAttributes()
   23. hasPointerCapture()
   24. insertAdjacentElement()
   25. insertAdjacentHTML()
   26. insertAdjacentText()
   27. matches()
   28. msZoomTo()
   29. prepend()
   30. querySelector()
   31. querySelector()
   32. querySelectorAll()
   33. querySelectorAll()
   34. releasePointerCapture()
   35. remove()
   36. removeAttribute()
   37. removeAttributeNode()
   38. removeAttributeNS()
   39. replaceChildren()
   40. replaceWith()
   41. requestFullscreen()
   42. requestPointerLock()
   43. scroll()
   44. scrollBy()
   45. scrollIntoView()
   46. scrollIntoViewIfNeeded()
   47. scrollTo()
   48. setAttribute()
   49. setAttributeNode()
   50. setAttributeNodeNS()
   51. setAttributeNS()
   52. setCapture()
   53. setPointerCapture()
   54. toggleAttribute()
4. 事件

   1. afterscriptexecute
   2. auxclick
   3. blur
   4. click
   5. compositionend
   6. compositionstart
   7. compositionupdate
   8. contextmenu
   9. copy
   10. cut
   11. dblclick
   12. DOMActivate
   13. DOMMouseScroll
   14. error
   15. focus
   16. focusin
   17. focusout
   18. fullscreenchange
   19. fullscreenerror
   20. gesturechange
   21. gestureend
   22. gesturestart
   23. keydown
   24. keypress
   25. keyup
   26. mousedown
   27. mouseenter
   28. mouseleave
   29. mousemove
   30. mouseout
   31. mouseover
   32. mouseup
   33. mousewheel
   34. MozMousePixelScroll
   35. msContentZoom
   36. MSGestureChange
   37. MSGestureEnd
   38. MSGestureHold
   39. MSGestureStart
   40. MSGestureTap
   41. MSInertiaStart
   42. MSManipulationStateChanged
   43. overflow
   44. paste
   45. scroll
   46. select
   47. show
   48. touchcancel
   49. touchend
   50. touchmove
   51. touchstart
   52. underflow
   53. webkitmouseforcechanged
   54. webkitmouseforcedown
   55. webkitmouseforceup
   56. webkitmouseforcewillbegin
   57. wheel
5. 继承：

   1. 节点
   2. EventTarget