大网数据广告活动
Web 标准与前端开发

Element:paste 事件

· 52CE 我爱测

当用户通过浏览器的用户界面发起“粘贴”动作时,将触发 **`paste`** 事件。

当用户通过浏览器的用户界面发起“粘贴”动作时,将触发 paste 事件。

如果光标处于可编辑的上下文中(例如,在 textarea 或 contenteditable 属性设置为 true 的元素中),那么默认动作是将剪贴板的内容插入光标位置的文档中。

事件处理器可以通过调用事件 clipboardData 属性的 DataTransfer/getData 方法来访问剪贴板内容。

要覆盖默认行为(例如插入一些不同的数据或转换剪贴板内容),事件处理程序必须使用 Event/preventDefault 取消默认动作,然后手动插入其想要的数据。

可以构建和派发一个合成 paste 事件,但这不会影响系统剪贴板或文档内容。

语法

在类似于 EventTarget.addEventListener 这样的方法中使用事件名,或设置事件处理器属性。

addEventListener("paste", (event) => {});

onpaste = (event) => {};

事件类型

ClipboardEvent。继承自 Event。

ClipboardEvent

示例

实时示例

HTML

<div class="source" contenteditable="true">从这个盒子复制文字</div>
<div class="target" contenteditable="true">在这里粘贴</div>
div.source,
div.target {
  border: 1px solid gray;
  margin: 0.5rem;
  padding: 0.5rem;
  height: 1rem;
  background-color: #e9eef1;
}

JavaScript

const target = document.querySelector("div.target");

target.addEventListener("paste", (event) => {
  event.preventDefault();

  let paste = (event.clipboardData || window.clipboardData).getData("text");
  paste = paste.toUpperCase();
  const selection = window.getSelection();
  if (!selection.rangeCount) return;
  selection.deleteFromDocument();
  selection.getRangeAt(0).insertNode(document.createTextNode(paste));
  selection.collapseToEnd();
});

结果

实时示例

规范

浏览器兼容性

参见

  • Element/cut_event 事件
  • Element/copy_event 事件

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。