ZeroClipboard 复制到剪贴板 中文文档

使用方法

载入 JavaScript 文件

<script src="ZeroClipboard.js"></script>

如果 ZeroClipboard.swf 与页面不在同一个目录下，可以设置路径

// 全局设置
ZeroClipboard.setDefaults({
    moviePath: ‘/path/ZeroClipboard.swf‘
}); 

// 参数中设置
var clip=new ZeroClipboard(document.getElementById("copy-button"), {
    moviePath: ‘/path/ZeroClipboard.swf‘
}); 

调用

可以传递一个元素或者一个元素数组。（这里使用 jQuery 获取元素的方式）

// 直接调用
var clip=new ZeroClipboard($(‘#my-button‘)); 

AMD

如果你使用 RequireJS, curl.js, seajs 等 AMD 规范的模块加载器，那么需要设置模块的 ID 或者路径的值到 amdModuleId，才能正常使用 ZeroClipboard。例：

define([‘path/to/zero-clipboard‘], function(ZeroClipboard){
    ZeroClipboard.setDefaults({
        amdModuleId: ‘path/to/zero-clipboard‘
    });
});

或者设置路径，RequireJS 的例子：

requirejs.config({
    paths:{
        "ZeroClipboard":"path/to/zero-clipboard"
    }
}); 

define(["ZeroClipboard"],function(ZeroClipboard) {
    ZeroClipboard.setDefaults({
        amdModuleId: ‘ZeroClipboard‘
    });
});

参数说明

new ZeroClipboard(elements [, options])

options 参数说明

参数 allowScriptAccess 选项的注意事项

1.1.7 及以下的版本，allowScriptAccess 的默认值为 always。意味着允许 "ZeroClipboard.swf" 文件托管的其他的域。为了提高安全性，1.1.7 之后的版本，allowScriptAccess 的默认值为 sameDomain，只允许 "ZeroClipboard.swf" 在相同域之下。

如果你是从 1.1.7 或更低的版本升级到 1.1.7 以上版本时，需要将 "ZeroClipboard.swf" 保存一份到相同域之下，或者设置 allowScriptAccess 的值为 always。

关于 allowScriptAccess 的更多信息，可以参考官方文档。

Data 属性

同时设置 data-clipboard-target 和 data-clipboard-text 两个属性时，只有在找不到 clipboard-target 的值时才会选用 clipboard-text

即使获取到 clipboard-target 的值为空，也不会选用 clipboard-text

API 方法

事件

通过 API 的方法 on() 来绑定

相关信息