当用户通过浏览器的用户界面发起“剪切”动作时,将触发 cut 事件。
如果用户尝试对不可编辑内容执行剪切操作,则 cut 事件仍会触发,但事件对象不包含任何数据。
该事件的默认行为是将当前选中的内容(如有)复制到系统剪贴板,并从当前文档中移除。
事件处理器可以通过调用 ClipboardEvent.clipboardData 属性上的 DataTransfer.setData 修改剪贴板内容,并通过 Event/preventDefault 取消默认行为。
但是请注意,取消默认动作也会阻止文档被更新。所以一个事件处理器想要在修改剪贴板时模仿默认动作“剪切”,也必须手动从文档中删除选择。
事件处理器不可以读取剪贴板数据。
可以构建和派发一个合成 cut 事件,但这不会影响系统剪贴板或文档内容。
语法
在类似于 EventTarget.addEventListener 这样的方法中使用事件名,或设置事件处理器属性。
addEventListener("cut", (event) => {});
oncut = (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 source = document.querySelector("div.source");
source.addEventListener("cut", (event) => {
const selection = document.getSelection();
event.clipboardData.setData("text/plain", selection.toString().toUpperCase());
selection.deleteFromDocument();
event.preventDefault();
});
结果
实时示例
规范
浏览器兼容性
参见
- Element/copy_event 事件
- Element/paste_event 事件
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
