载入 JavaScript 文件

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

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

1. // 全局设置 
2. ZeroClipboard.setDefaults({ 
3.   moviePath: '/path/ZeroClipboard.swf' 
4. }); 
5.  
6. // 参数中设置 
7. var clip=new ZeroClipboard(document.getElementById("copy-button"), { 
8.   moviePath: '/path/ZeroClipboard.swf' 
9. }); 

调用

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

1. // 直接调用 
2. var clip=new ZeroClipboard($('#my-button')); 

AMD

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

1. define(['path/to/zero-clipboard'], function(ZeroClipboard){ 
2.   ZeroClipboard.setDefaults({ 
3.     amdModuleId: 'path/to/zero-clipboard' 
4.   }); 
5. }); 

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

1. requirejs.config({ 
2.   paths:{ 
3.     "ZeroClipboard":"path/to/zero-clipboard" 
4.   } 
5. }); 
6.  
7. define(["ZeroClipboard"],function(ZeroClipboard) { 
8.   ZeroClipboard.setDefaults({ 
9.     amdModuleId: 'ZeroClipboard' 
10.   }); 
11. }); 

1. new ZeroClipboard(elements [, options])

options 参数说明

名称	默认值	说明
swfPath	"ZeroClipboard.swf"	Flash 文件路径，默认的 swf 文件路径与 ZeroClipboard.js 相同
trustedDomains	window.location.host ? [window.location.host] : []	可信任的域（字符串或者字符串的数组）
cacheBust	true
forceEnhancedClipboard	false
flashLoadTimeout	30000	加载 Flash 的超时时间，如果不需要，可以设置为 0。单位（ms）
autoActivate	true
bubbleEvents	true
containerId	"global-zeroclipboard-html-bridge"
containerClass	"global-zeroclipboard-container"
swfObjectId	"global-zeroclipboard-flash-bridge"
hoverClass	"zeroclipboard-is-hover"	鼠标移上时给元素增加的 Class
activeClass	"zeroclipboard-is-active"	选定是给元素增加的 Class
forceHandCursor	false
title	null
zIndex	999999999

参数 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-clipboard-target	元素ID。查找该元素后，尝试复制元素的 .value 或 .textContent 或 .innerText 的值
data-clipboard-text	默认复制的内容。

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

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

名称	说明
glue(dom)	绑定到元素
reposition()	调整位置
on("Event",my_load_handler)	绑定事件
off("Event",my_load_handler)	取消已绑定的事件

---

下载