学步园

chipboard

该API允许调用者和操作系统的剪切板交互，存取其中的内容。

你可以设定剪切板中的数据类型。目前支持的类型有文本(text)和html两种。如果没有指定类型，API会自动地检测类型。

例如：

剪切板中文本的存取：

var clipboard = require("clipboard");
clipboard.set("Lorem ipsum dolor sit amet");
var contents = clipboard.get();

向剪切板中存入html:

var clipboard = require("clipboard");
clipboard.set("<blink>Lorem ipsum dolor sit amet</blink>", "html");

将剪切板中已有的html在一个新的标签页中打开：

var clipboard = require("clipboard");
if (clipboard.currentFlavors.indexOf("html") != -1)
  require("tabs").open("data:text/html," + clipboard.get("html"));

向剪切板中存入图片：

var clipboard = require("clipboard");
clipboard.set("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYA" +
              "AABzenr0AAAASUlEQVRYhe3O0QkAIAwD0eyqe3Q993AQ3cBSUKpygfsNTy" +
              "N5ugbQpK0BAADgP0BRDWXWlwEAAAAAgPsA3rzDaAAAAHgPcGrpgAnzQ2FG" +
              "bWRR9AAAAABJRU5ErkJggg%3D%3D");

将剪切板中已有的图片在新的标签页中打开：

var clipboard = require("clipboard");
if (clipboard.currentFlavors.indexOf("image") != -1)
  require("tabs").open(clipboard.get());

其中图片的数据类型可以省略。

API文档：

方法：

set(data, datatype)

用用户指定类型的数据替换剪切板中的内容

data:string

放入剪切板中内容

[datatype:string]

数据的类型，可选的

get(datatype)

从剪切板中获得内容

[datatype:string]

取出剪切板中的内容，当且仅当内容的类型和指定的类型匹配时（可选的），当没有匹配时，放回null。

属性：

currentFlavors: array

剪切板中的内容有时候可以以多种类型存在，例如，html数据可以以html或者text类型获取到，改属性返回当前剪切板中数据的所有可有类型的一个数组。