clipboard-dom

Copy-to-Clipboard on a DOM element

npm install clipboard-dom
1 downloads in the last day
9 downloads in the last week
23 downloads in the last month

clipboard-dom

Makes a DOM element (i.e. <button>) write to the system clipboard. This component is based off of the ZeroClipboard project, and in fact uses the same SWF Flash code.

Installation

$ component install component/clipboard-dom

Example

<html>
  <body>
    <!-- The "copy-button" *should* be inside a div with "position: relative"
         or something else that "has layout". -->
    <div style="position: relative;">
      <button id="copy-button">Copy to Clipboard</button>
    </div>
    <script src="build/build.js"></script>
    <script src="main.js"></script>
  </body>
</html>
// main.js

var Clip = require('clipboard-dom');

// set the path to the swf file first
Clip.swf('/swf/ZeroClipboard.swf');

// create a "Clip" instance
var ele = document.getElementById('copy-button');
var parent = ele.parentNode; // parent should "have layout"
var clip = new Clip(ele, parent);

// listen for meaningful events
clip.on('load', function(){
  console.log('button loaded');
});

clip.on('completed', function(text){
  console.log('copied text to the clipboard:', text);
});

clip.on('mousedown', function() {
  // "mousedown" is the last chance to set the text before it gets copied
  var input = document.getElementById('copy-text');
  clip.text(input.value);
});

Events

"load"

Fired when the SWF movie for the clipboard instance has loaded.

"complete"

Fired when the user clicks on the button and the text has been copied. The text that got copied is passed in as an argument.

"mouseover"

Fired when the user mouses over the button.

"mouseout"

Fired when the user mouses away from the button.

"mousedown"

Fired when the user pressed the mouse down on the button.

"mouseup"

Fired when the user releases the mouse from the button.

npm loves you