我从Typora中学到的Clipboard妙用.md

简介: Clipboard复制数据

Typora是我经常使用的一款软件,用来写MarkDown很舒适,有着非常优秀的使用体验:

  • 实时预览
  • 自定义图片上传服务
  • 文档转换
  • 主题自定义

起因

不过我遇到一个非常好玩的事情,当我复制Typora内容粘贴到文本编辑器时,会得到MarkDown格式的内容;复制到富文本编辑器时,可以渲染出富文本效果:

复制到VS Code:

VS Code

复制到其他富文本编辑器:

富文本编辑器

我很好奇为什么会出现两种不同的结果,Typora应该是使用Electron(或类似技术)开发的,我尝试用Clipboard API来进行测试:

// 为什么使用setTimeout:我是在Chrome控制台进行的测试,clipboard依托于页面,所以我需要设置1s延时,以便可以点击页面聚焦
setTimeout(async()=>{
    const clipboardItems = await navigator.clipboard.read();
    console.log(clipboardItems)
},1000)

然后看到了剪切板中有两种不同类型的内容:纯文本text/plain和富文本text/html。所以不同的内容接收者选择了不同的内容作为数据,文本编辑器拿到的是纯文本,富文本编辑器获取的是富文本格式数据。

结果

再来看看获取到的具体内容吧:

setTimeout(async()=>{
    const clipboardItems = await navigator.clipboard.read();
    console.log(clipboardItems)
    for (const clipboardItem of clipboardItems) {
      for (const type of clipboardItem.types) {
        const contentBlob = await clipboardItem.getType(type)
        const text = await contentBlob.text()
        console.log(text)
      }
    }
},1000)

image-20211117193144843

Clipboard塞入数据试一下:

setTimeout(async ()=>{
await navigator.clipboard.write([
      new ClipboardItem({
        ["text/plain"]: new Blob(['# 纯文本和富文本'],{type:'text/plain'}),
        ["text/html"]: new Blob(['<h1 cid="n21" mdtype="heading" class="md-end-block md-heading md-focus" style="box-sizing: border-box; break-after: avoid-page; break-inside: avoid; orphans: 4; font-size: 2.25em; margin-top: 1rem; margin-bottom: 1rem; position: relative; font-weight: bold; line-height: 1.2; cursor: text; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: rgb(238, 238, 238); white-space: pre-wrap; caret-color: rgb(51, 51, 51); color: rgb(51, 51, 51); font-family: "Open Sans", "Clear Sans", "Helvetica Neue", Helvetica, Arial, "Segoe UI Emoji", sans-serif; font-style: normal; font-variant-caps: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none;"><span md-inline="plain" class="md-plain md-expand" style="box-sizing: border-box;">纯文本和富文本</span></h1>'],{type:'text/html'}),
      })
    ]);
},[1000])

尝试了几个富文本编辑器得到的结果(不同富文本编辑器的具体实现可能存在差异):

  • 如果只存在纯文本(仅保留上段代码中的纯文本部分), 会读取剪切板中纯文本内容
  • 如果存在纯文本和富文本,会读取剪切板中富文本内容

那这个效果是Typora帮我们实现的吗?

我们先来看一下复制富文本的默认行为,打开一个网页,复制网页文本,然后使用刚才的代码尝试一下,看看读取到的剪切板内容。

image-20211118103737687

我们可以看到,在复制富文本的时候,Chrome实现的clipboard API都会生成两份结果,一份是纯文本格式text/plain,一份是富文本格式text/html

不同的是:当我们在Typora复制时,得到的是Markdown格式的纯文本和富文本,是Typora帮我们进行了处理。

监听复制,写入剪切板

监听复制我们可以使用HTMLElement.oncopy实现:

打开任意一个网页,切换到控制台:

document.body.oncopy = function(e){
      console.log(e)
    var text = e.clipboardData.getData("text");
    console.log(text)
}

复制页面中内容,我们就可以的看到打印的结果了:

监听复制

本来为数据会在clipboardData中,但是尝试了一下并没有获取到内容,看了一下API, 需要在copy事件中通过setData设置数据,在paste时间中getData获取数据。我们可以通过Selection API来获取选中的内容。

document.addEventListener('copy', function(e){
      e.preventDefault(); // 防止我们筛入的数据被覆盖
    const selectionObj = window.getSelection()
        const rangeObj = selectionObj.getRangeAt(0)
    const fragment = rangeObj.cloneContents() // 获取Range包含的文档片段
    const wrapper = document.createElement('div')
    wrapper.append(fragment)
    e.clipboardData.setData('text/plain', wrapper.innerText + '额外的文本');
    e.clipboardData.setData('text/html', wrapper.innerHTML+ '<h1>额外的文本</h1>');
});

或者使用clipboard.write实现写入:

document.body.oncopy = function(e){
    e.preventDefault();
    const selectionObj = window.getSelection()
        const rangeObj = selectionObj.getRangeAt(0)
    const fragment = rangeObj.cloneContents() // 获取Range包含的文档片段
    const wrapper = document.createElement('div')
    wrapper.append(fragment)
    navigator.clipboard.write([
      new ClipboardItem({
        ["text/plain"]: new Blob([wrapper.innerText,'额外的文本'],{type:'text/plain'}),
        ["text/html"]: new Blob([wrapper.innerHTML,'<h1>额外的富文本</h1>'],{type:'text/html'}),
      })
    ])
}

监听复制还可以用来添加版权信息,比如上面代码中的额外信息就会出现在复制的文本中。

对于复制和粘贴内容也可以通过document.execCommand,不过目前属于已经被弃用的API,不建议使用

更多文章欢迎关注“混沌前端”

参考文档:

ClipboardItem

Clipboard-write

element.oncopy

Selection

Range

相关文章
|
6月前
【Typora】markdown神器之Typora无限使用安装与基本操作教程
【Typora】markdown神器之Typora无限使用安装与基本操作教程
218 3
|
3天前
|
程序员
【Markdown速成】半小时入门Markdown教程(后缀.md文件详解)
作为程序员我们经常会看到README.md这种说明文件,以.md为后缀的文件就是我们所说的Markdown的文件。
|
4月前
|
存储 JavaScript Python
word文档转成Markdown文档并在Typora免费版添加图床-----想想都很香
word文档转成Markdown文档并在Typora免费版添加图床-----想想都很香
154 0
|
6月前
|
存储 JSON 缓存
Python基础教程——文件I/O
Python基础教程——文件I/O
[Emoji cheat sheet]写博客时会使用的Emoji可爱表情符号
[Emoji cheat sheet]写博客时会使用的Emoji可爱表情符号
|
前端开发 程序员
Typora基本使用&Markdown基本语法:精炼且详细
Typora基本使用&Markdown基本语法:精炼且详细
457 0
MarkDown语法与Typora的使用—从此告别Word方式做笔记
MarkDown语法与Typora的使用—从此告别Word方式做笔记
|
存储 编译器 uml
使用Typora学习MarkDown语法
使用Typora学习MarkDown语法
140 0
使用Typora学习MarkDown语法
|
前端开发 C++ iOS开发
Markdown开源神器MarkText替换Typora.
Markdown开源神器MarkText替换Typora,推荐开源的Markdown神器!
Markdown开源神器MarkText替换Typora.
|
搜索推荐 数据可视化 开发者