README

警告

此 master 分支包含 ZeroClipboard 的 v2.x 代码库！对于 v1.x 代码库，请参阅 1.x-master 分支。

ZeroClipboard

ZeroClipboard 库提供了一种简单的方法，通过不可见的 Adobe Flash 影片和 JavaScript 接口将文本复制到剪贴板。"Zero" 表示库本身不可见，用户界面完全由您控制。

这是通过自动将不可见的影片浮于您选择的 DOM 元素之上实现的。标准的鼠标事件甚至可以传播到您的 DOM 元素，因此您仍然可以实现悬停和鼠标按下效果。

限制

需要用户交互

由于浏览器和 Flash 的安全限制，此剪贴板注入只能在用户点击不可见的 Flash 影片时发生。仅从 JavaScript 模拟的 click 事件不足以满足这一需求，因为这会导致剪贴板中毒。

其他限制

有关限制的完整列表，请参阅 docs/instructions.md#limitations。

简单示例

<html>
  <body>
    <button id="copy-button" data-clipboard-text="Copy Me!" title="Click to copy me.">Copy to Clipboard</button>
    <script src="ZeroClipboard.js"></script>
    <script src="main.js"></script>
  </body>
</html>

// main.js
var client = new ZeroClipboard( document.getElementById("copy-button") );

client.on( "ready", function( readyEvent ) {
  // alert( "ZeroClipboard SWF is ready!" );

  client.on( "aftercopy", function( event ) {
    // `this` === `client`
    // `event.target` === the element that was clicked
    event.target.style.display = "none";
    alert("Copied text to clipboard: " + event.data["text/plain"] );
  } );
} );

有关在您的网站上使用库的更高级选项，请参阅 docs/instructions.md。有关完整的 API 文档，请参阅 docs/api/ZeroClipboard.md。

这是一个测试页面，您可以在其中尝试在浏览器中使用 ZeroClipboard。

本地测试 ZeroClipboard

要本地测试演示页面，请克隆网站仓库。

支持

此库完全兼容 Flash Player 11.0.0 及以上版本，要求剪贴板复制操作由 Flash 影片内的用户点击事件触发。这是通过自动将不可见的影片浮于您选择的 DOM 元素之上实现的。标准的鼠标事件甚至可以传播到您的 DOM 元素，因此您只需稍加努力就可以实现悬停和鼠标按下效果。

预计 ZeroClipboard v2.x 将在 IE9+ 和所有永续浏览器中工作。尽管在 v2.0.0 中正式放弃了 IE7 & IE8 的支持，但实际上它仍然在 v2.0.2 中得到了技术支持。

贡献

请参阅 CONTRIBUTING.md

发布

从版本 1.1.7 开始，ZeroClipboard 使用语义化版本控制。

请参阅发布记录

路线图

请参阅 roadmap.md

huebs / zeroclipboard

维护者

详细信息