clipboard

在系统剪贴板上执行复制和粘贴操作。

进程: Main, Renderer

在 Linux 上,还有一个 selection 粘贴板 。 想要操作该剪切板,你需要为每个函数传递 selection 参数。

  1. const { clipboard } = require('electron')
  2. clipboard.writeText('Example String', 'selection')
  3. console.log(clipboard.readText('selection'))

方法

clipboard 对象具有以下方法:

注意: 被标记为实验性的 api 将来可能被删除。

clipboard.readText([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 String- 剪贴板中的纯文本内容。

  1. const { clipboard } = require('electron')
  2. clipboard.writeText('hello i am a bit of text!')
  3. const text = clipboard.readText()
  4. console.log(text)
  5. // hello i am a bit of text!'

clipboard.writeText(text[, type])

  • text String
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

text 作为纯文本写入剪贴板。

  1. const { clipboard } = require('electron')
  2. const text = 'hello i am a bit of text!'
  3. clipboard.writeText(text)

clipboard.readHTML([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 String- 剪贴板中的HTML内容。

  1. const { clipboard } = require('electron')
  2. clipboard.writeHTML('<b>Hi</b>')
  3. const html = clipboard.readHTML()
  4. console.log(html)
  5. // <meta charset='utf-8'><b>Hi</b>

clipboard.writeHTML(markup[, type])

  • markup String
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

markup 写入剪贴板。

  1. const { clipboard } = require('electron')
  2. clipboard.writeHTML('<b>Hi</b')

clipboard.readImage([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 NativeImage- 剪贴板中的图像内容。

clipboard.writeImage(image[, type])

  • image NativeImage
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

image 写入剪贴板。

clipboard.readRTF([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 String- 剪贴板中的RTF内容。

  1. const { clipboard } = require('electron')
  2. clipboard.writeRTF('{\\rtf1\\ansi{\\fonttbl\\f0\\fswiss Helvetica;}\\f0\\pard\nThis is some {\\b bold} text.\\par\n}')
  3. const rtf = clipboard.readRTF()
  4. console.log(rtf)
  5. // {\\rtf1\\ansi{\\fonttbl\\f0\\fswiss Helvetica;}\\f0\\pard\nThis is some {\\b bold} text.\\par\n}

clipboard.writeRTF(text[, type])

  • text String
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

向剪贴板中写入 RTF 格式的 text.

  1. const { clipboard } = require('electron')
  2. const rtf = '{\\rtf1\\ansi{\\fonttbl\\f0\\fswiss Helvetica;}\\f0\\pard\nThis is some {\\b bold} text.\\par\n}'
  3. clipboard.writeRTF(rtf)

clipboard.readBookmark() macOS Windows

返回 Object:

  • title String
  • url String

返回一个对象, 其中包含表示剪贴板中书签 titleurl 。 当书签不可用时, titleurl 值将为空字符串。

clipboard.writeBookmark(title, url[, type]) macOS Windows

  • title String
  • url String
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

将书签的 titleurl 写入剪贴板。

注意:Windows上的大多数应用程序不支持粘贴书签,因此你可以使用 clipboard.write 将书签和后备文本写入剪贴板。

  1. const { clipboard } = require('electron')
  2. clipboard.writeBookmark({
  3. text: 'https://electronjs.org',
  4. bookmark: 'Electron Homepage'
  5. })

clipboard.readFindText() macOS

返回 String - “查找粘贴板”上的文本,这是保存有关活动应用程序查找面板当前状态信息的粘贴板。

此方法从渲染进程调用时使用同步 IPC。 每当激活应用程序时, 都会从查找粘贴板中重新读取缓存值。

clipboard.writeFindText(text) macOS

  • text String

text 作为纯文本写入查找粘贴板(粘贴板上有关于当前应用程序查找面板状态的信息)。 此方法从渲染进程调用时使用同步 IPC。

clipboard.clear([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

清除剪贴板内容。

clipboard.availableFormats([type])

  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 String []- 剪贴板 type 所支持的格式的数组。

  1. const { clipboard } = require('electron')
  2. const formats = clipboard.availableFormats()
  3. console.log(formats)
  4. // [ 'text/plain', 'text/html' ]

clipboard.has(format[, type]) 实验功能

  • format String
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

返回 Boolean, 剪贴板是否支持指定的 format

  1. const { clipboard } = require('electron')
  2. const hasFormat = clipboard.has('public/utf8-plain-text')
  3. console.log(hasFormat)
  4. // 'true' or 'false'

clipboard.read(format) 实验功能

  • format String

返回 String- 从剪贴板中读取 format 类型的内容。

format 应该包含有效的 ASCII 字符和 / 分隔符。 a/c, a/bc 是有效格式,然而 /abc, abc/, a/, /a, a 是无效格式。

clipboard.readBuffer(format) 实验功能

  • format String

返回 Buffer- 从剪贴板中读取 format 类型的内容。

  1. const { clipboard } = require('electron')
  2. const buffer = Buffer.from('this is binary', 'utf8')
  3. clipboard.writeBuffer('public/utf8-plain-text', buffer)
  4. const ret = clipboard.readBuffer('public/utf8-plain-text')
  5. console.log(buffer.equals(out))
  6. // true

clipboard.writeBuffer(format, buffer[, type]) 实验功能

  • format String
  • buffer Buffer
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

buffer 作为 format 类型写入剪贴板。

  1. const { clipboard } = require('electron')
  2. const buffer = Buffer.from('writeBuffer', 'utf8')
  3. clipboard.writeBuffer('public/utf8-plain-text', buffer)

clipboard.write(data[, type])

  • data Object
    • text String(可选)
    • html String(可选)
    • image NativeImage (可选)
    • rtf String (可选)
    • bookmark String (可选)- URL 的标题 text
  • type String (optional) -可以是 selectionclipboard; 默认为 ‘clipboard’. selection 仅在 Linux 中可用。

data 写入剪贴板。

  1. const { clipboard } = require('electron')
  2. clipboard.write({
  3. text: 'test',
  4. html: '<b>Hi</b>',
  5. rtf: '{\\rtf1\\utf8 text}',
  6. bookmark: 'a title'
  7. })
  8. console.log(clipboard.readText())
  9. // 'test'
  10. console.log(clipboard.readHTML())
  11. // <meta charset='utf-8'><b>Hi</b>
  12. console.log(clipboard.readRTF())
  13. // '{\\rtf1\\utf8 text}'
  14. console.log(clipboard.readBookmark())
  15. // { title: 'a title', url: 'test' }