# zeroclipboard
> The ZeroClipboard library provides an easy way to copy text to the clipboard using an invisible Adobe Flash movie and a JavaScript interface
Latest version **2.3.0** (published 2016-12-12) · MIT license · 0 weekly downloads
## Install
```sh
npm install zeroclipboard
pnpm add zeroclipboard
yarn add zeroclipboard
bun add zeroclipboard
```
## Health
**Score 23/100 (F)** — status: abandoned.
Positive: has types package; no vulnerabilities; high quality score.
Warnings: low downloads; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 2.3.0 |
| Published | 2016-12-12 |
| First published | 2012-12-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/zeroclipboard) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6583 |
| Maintainers | jonrohan, jamesmgreene |
| Keywords | flash, clipboard, copy, cut, paste, zclip, clip, clippy |
## Links
- npm: https://www.npmjs.com/package/zeroclipboard
- Repository: https://github.com/zeroclipboard/zeroclipboard
- Homepage: http://zeroclipboard.org/
- Issues: https://github.com/zeroclipboard/zeroclipboard/issues
- npm.io page: https://npm.io/package/zeroclipboard
## Recent versions
- 2.3.0 (latest) — 2016-12-12
- 1.2.2 (1.2.2) — 2014-01-21
- 2.2.0 — 2014-12-29
- 2.1.6 — 2014-07-27
- 2.1.5 — 2014-07-03
- 2.1.4 — 2014-07-03
- 2.1.3 — 2014-06-25
- 2.1.2 — 2014-06-17
- 2.1.1 — 2014-06-11
- 2.1.0 — 2014-06-11
- 2.0.3 — 2014-06-09
- 2.0.2 — 2014-06-09
- 2.0.1 — 2014-06-05
- 2.0.0 — 2014-06-03
- 2.0.0-beta.8 — 2014-05-24
- … 23 more at https://npm.io/package/zeroclipboard/versions
## README
### WARNING
**This `master` branch contains the `v2.x` codebase for ZeroClipboard! For the `v1.x` codebase, see the [`1.x-master`](https://github.com/zeroclipboard/zeroclipboard/tree/1.x-master) branch instead.**
# ZeroClipboard
[](https://github.com/zeroclipboard/zeroclipboard) [](https://travis-ci.org/zeroclipboard/zeroclipboard)  [](https://coveralls.io/r/zeroclipboard/zeroclipboard?branch=master) [](https://david-dm.org/zeroclipboard/zeroclipboard) [](https://david-dm.org/zeroclipboard/zeroclipboard#info=devDependencies)
The ZeroClipboard library provides an easy way to copy text to the clipboard using an invisible [Adobe Flash](http://en.wikipedia.org/wiki/Adobe_Flash) movie and a [JavaScript](http://en.wikipedia.org/wiki/JavaScript) interface. The "Zero" signifies that the library is invisible and the user interface is left entirely up to you.
This is achieved by automatically floating the invisible movie on top of a [DOM](http://en.wikipedia.org/wiki/Document_Object_Model) element of your choice. Standard mouse events are even propagated out to your DOM element, so you can still have rollover and mousedown effects.
Suggestions welcome read over the [contributing](/CONTRIBUTING.md) guidelines.
## Setup
To setup the project for local development start with these commands in your terminal.
```sh
$ git clone https://github.com/zeroclipboard/zeroclipboard.git
$ cd zeroclipboard/
$ npm install -g grunt-cli
$ npm install
$ grunt
```
## Development
Before submitting a pull request you'll need to validate, build, and test your code. Run the default grunt task in your terminal.
```sh
$ grunt
```
## Testing
If you just want to run the tests, run grunt test.
```sh
$ grunt test
```
## Limitations
### User Interaction Required
Due to browser and Flash security restrictions, this clipboard injection can _**ONLY**_ occur when
the user clicks on the invisible Flash movie. A simulated `click` event from JavaScript will not
suffice as this would enable [clipboard poisoning](http://www.computerworld.com/s/article/9117268/Adobe_patches_Flash_clickjacking_and_clipboard_poisoning_bugs).
### Other Limitations
For a complete list of limitations, see [docs/instructions.md#limitations](docs/instructions.md#limitations).
On that page, you will also find an [explanation of why ZeroClipboard will _NOT_ work by default on code playground sites](docs/instructions.md#starter-snippets-for-playground-sites) like JSFiddle, JSBin, and CodePen, as well as the appropriate "View" URLs to use on those sites in order to allow ZeroClipboard to work.
## Simple Example
```html
```
```js
// 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"] );
} );
} );
```
See [docs/instructions.md](docs/instructions.md) for more advanced options in using the library on your site.
See [docs/api/ZeroClipboard.md](docs/api/ZeroClipboard.md) for the complete API documentation.
Here is a working [test page](http://zeroclipboard.org/#demo) where you can try out ZeroClipboard in your browser.
## Testing ZeroClipboard Locally
To test the page [demo page](http://zeroclipboard.org/#demo) locally, clone the [website repo](https://github.com/zeroclipboard/zeroclipboard.org).
## Support
This library is fully compatible with Flash Player 11.0.0 and above, 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](http://en.wikipedia.org/wiki/Document_Object_Model) element of your
choice. Standard mouse events are even propagated out to your DOM element, so you
can still have rollover and mousedown effects with just a _little_ extra effort.
ZeroClipboard `v2.x` is expected to work in IE9+ and all of the evergreen browsers.
Although support for IE7 & IE8 was officially dropped in `v2.0.0`, it was actually
still _technically_ supported through `v2.0.2`.
## Releases
Starting with version [1.1.7](https://github.com/zeroclipboard/zeroclipboard/releases/tag/v1.1.7), ZeroClipboard uses [semantic versioning](http://semver.org/).
see [releases](https://github.com/zeroclipboard/zeroclipboard/releases)
## Related
* [jquery.zeroclipboard](https://github.com/zeroclipboard/jquery.zeroclipboard)
* [zeroclipboard-rails](https://github.com/zeroclipboard/zeroclipboard-rails)
## License
MIT © [James M. Greene](http://greene.io/) [Jon Rohan](http://jonrohan.codes)
---
_Source: https://npm.io/package/zeroclipboard · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._