rogeriopradoj/zero-clipboard

Deprecated - Please check official version now avaliable (https://packagist.org/packages/zeroclipboard/zeroclipboard)

ZeroClipboard

The ZeroClipboard library provides an easy way to copy text to the clipboard using an invisible Adobe Flash movie, and a JavaScript interface. The "Zero" signifies that the library is invisible and the user interface is left entirely up to you., _(*1)

Simple Example

``` html , <sub>(*2)</sub>

``` js
// main.js
var clip = new ZeroClipboard( document.getElementById("copy-button"), {
  moviePath: "/path/to/ZeroClipboard.swf"
} );

clip.on( 'load', function(client) {
  // alert( "movie is loaded" );
} );

clip.on( 'complete', function(client, args) {
  this.style.display = 'none'; // "this" is the element that was clicked
  alert("Copied text to clipboard: " + args.text );
} );

clip.on( 'mouseover', function(client) {
  // alert("mouse over");
} );

clip.on( 'mouseout', function(client) {
  // alert("mouse out");
} );

clip.on( 'mousedown', function(client) {

  // alert("mouse down");
} );

clip.on( 'mouseup', function(client) {
  // alert("mouse up");
} );

See the instructions for advanced instructions on how to use the library on your site., <sub>(*3)</sub>

Here is a working test page where you can try out ZeroClipboard in your browser., <sub>(*4)</sub>

Testing ZeroClipboard.swf Locally

To test the page demo page locally. checkout the gh-pages branch and run make. This should open localhost:3000, <sub>(*5)</sub>

git co gh-pages
make

add BRANCH=my-dev-branch to get the assets from a certain branch, <sub>(*6)</sub>

git co gh-pages
make BRANCH=my-dev-branch

Support

This library is fully compatible with Flash Player 10, which requires that the clipboard copy operation be initiated by a user click event inside the Flash movie. This is achieved by automatically floating the invisible movie on top of a DOM element of your choice. Standard mouse events are even propagated out to your DOM element, so you can still have rollover and mouse down effects., <sub>(*7)</sub>

Works in IE8+. Works in IE7 but requires Sizzle/jQuery. (And of course works in all of the other browsers.), <sub>(*8)</sub>

Contributing

see CONTRIBUTING.md, <sub>(*9)</sub>

Releases

After version 1.1.7 ZeroClipboard uses semantic versioning, <sub>(*10)</sub>

see releases.md, <sub>(*11)</sub>

Roadmap

see roadmap.md, <sub>(*12)</sub>

Last Build

, <sub>(*13)</sub>