2.0.1

Update package.json (#532 )
Correct module path
2023-08-10 21:12:48 +03:00 · 2018-04-29 16:41:13 -07:00 · 2018-04-29 16:14:20 -07:00 · 2018-03-01 09:07:10 -08:00 · 2018-02-28 21:56:32 -08:00 · 2018-02-28 21:46:48 -08:00
24 changed files with 1012 additions and 691 deletions
--- a/.babelrc
+++ b/.babelrc
@@ -0,0 +1,4 @@
+{
+  "presets": ["es2015"],
+  "plugins": ["transform-es2015-modules-umd"]
+}
--- a/.banner
+++ b/.banner
@@ -1,6 +0,0 @@
-/*!
- * clipboard.js v<%= pkg.version %>
- * https://zenorocha.github.io/clipboard.js
- *
- * Licensed MIT © Zeno Rocha
- */
--- a/.github/issue_template.md
+++ b/.github/issue_template.md
@@ -0,0 +1,15 @@
+### Minimal example
+
+> Fork this [JSFiddle](https://jsfiddle.net/zenorocha/5kk0eysw/) and reproduce your issue.
+
+### Expected behaviour
+
+I thought that by going to the page '...' and pressing the button '...' then '...' would happen.
+
+### Actual behaviour
+
+Instead of '...', what I saw was that '...' happened instead.
+
+### Browsers affected
+
+I tested on all major browsers and only IE 11 does not work.
--- a/bower.json
+++ b/bower.json
@@ -1,7 +1,7 @@
 {
  "name": "clipboard",
-  "version": "1.5.8",
-  "description": "Modern copy to clipboard. No Flash. Just 2kb",
+  "version": "2.0.0",
+  "description": "Modern copy to clipboard. No Flash. Just 3kb",
  "license": "MIT",
  "main": "dist/clipboard.js",
  "ignore": [
--- a/composer.json
+++ b/composer.json
@@ -0,0 +1,25 @@
+{
+  "name": "zenorocha/clipboardjs",
+  "description": "Modern copy to clipboard. No Flash. Just 3kb gzipped https://clipboardjs.com",
+  "type": "component",
+  "homepage": "https://clipboardjs.com/",
+  "authors": [
+    {
+      "name": "Zeno Rocha",
+      "url": "http://zenorocha.com/"
+    }
+  ],
+  "require": {
+    "robloach/component-installer": "*"
+  },
+  "extra": {
+    "component": {
+      "scripts": [
+        "dist/clipboard.js"
+      ],
+      "files": [
+        "dist/clipboard.min.js"
+      ]
+    }
+  }
+}
--- a/demo/constructor-node.html
+++ b/demo/constructor-node.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>constructor-node</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -16,7 +17,7 @@
    <!-- 3. Instantiate clipboard by passing a HTML element -->
    <script>
    var btn = document.getElementById('btn');
-    var clipboard = new Clipboard(btn);
+    var clipboard = new ClipboardJS(btn);

    clipboard.on('success', function(e) {
        console.log(e);
--- a/demo/constructor-nodelist.html
+++ b/demo/constructor-nodelist.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>constructor-nodelist</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -16,7 +17,7 @@
    <!-- 3. Instantiate clipboard by passing a list of HTML elements -->
    <script>
    var btns = document.querySelectorAll('button');
-    var clipboard = new Clipboard(btns);
+    var clipboard = new ClipboardJS(btns);

    clipboard.on('success', function(e) {
        console.log(e);
--- a/demo/constructor-selector.html
+++ b/demo/constructor-selector.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>constructor-selector</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -15,7 +16,7 @@

    <!-- 3. Instantiate clipboard by passing a string selector -->
    <script>
-    var clipboard = new Clipboard('.btn');
+    var clipboard = new ClipboardJS('.btn');

    clipboard.on('success', function(e) {
        console.log(e);
--- a/demo/function-target.html
+++ b/demo/function-target.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>function-target</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -14,7 +15,7 @@

    <!-- 3. Instantiate clipboard -->
    <script>
-    var clipboard = new Clipboard('.btn', {
+    var clipboard = new ClipboardJS('.btn', {
        target: function() {
            return document.querySelector('div');
        }
--- a/demo/function-text.html
+++ b/demo/function-text.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>function-text</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -13,7 +14,7 @@

    <!-- 3. Instantiate clipboard -->
    <script>
-    var clipboard = new Clipboard('.btn', {
+    var clipboard = new ClipboardJS('.btn', {
        text: function() {
            return 'to be or not to be';
        }
--- a/demo/target-div.html
+++ b/demo/target-div.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>target-div</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -14,7 +15,7 @@

    <!-- 3. Instantiate clipboard -->
    <script>
-    var clipboard = new Clipboard('.btn');
+    var clipboard = new ClipboardJS('.btn');

    clipboard.on('success', function(e) {
        console.log(e);
--- a/demo/target-input.html
+++ b/demo/target-input.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>target-input</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -14,7 +15,7 @@

    <!-- 3. Instantiate clipboard -->
    <script>
-    var clipboard = new Clipboard('.btn');
+    var clipboard = new ClipboardJS('.btn');

    clipboard.on('success', function(e) {
        console.log(e);
--- a/demo/target-textarea.html
+++ b/demo/target-textarea.html
@@ -3,6 +3,7 @@
 <head>
    <meta charset="UTF-8">
    <title>target-textarea</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 </head>
 <body>
    <!-- 1. Define some markup -->
@@ -14,7 +15,7 @@

    <!-- 3. Instantiate clipboard -->
    <script>
-    var clipboard = new Clipboard('.btn');
+    var clipboard = new ClipboardJS('.btn');

    clipboard.on('success', function(e) {
        console.log(e);
--- a/dist/clipboard.js
+++ b/dist/clipboard.js
--- a/dist/clipboard.min.js
+++ b/dist/clipboard.min.js
--- a/karma.conf.js
+++ b/karma.conf.js
@@ -1,8 +1,10 @@
-module.exports = function(karma) {
-    karma.set({
-        plugins: ['karma-browserify', 'karma-chai', 'karma-sinon', 'karma-mocha', 'karma-phantomjs-launcher'],
+var webpackConfig = require('./webpack.config.js');

-        frameworks: ['browserify', 'chai', 'sinon', 'mocha'],
+module.exports = function (karma) {
+    karma.set({
+        plugins: ['karma-webpack', 'karma-chai', 'karma-sinon', 'karma-mocha', 'karma-phantomjs-launcher'],
+
+        frameworks: ['chai', 'sinon', 'mocha'],

        files: [
            'src/**/*.js',
@@ -10,18 +12,20 @@ module.exports = function(karma) {
            './node_modules/phantomjs-polyfill/bind-polyfill.js'
        ],

-        exclude: ['test/module-systems.js'],
-
        preprocessors: {
-            'src/**/*.js' : ['browserify'],
-            'test/**/*.js': ['browserify']
+            'src/**/*.js': ['webpack'],
+            'test/**/*.js': ['webpack']
        },

-        browserify: {
-            debug: true,
-            transform: ['babelify']
+        webpack: {
+            module: webpackConfig.module,
+            plugins: webpackConfig.plugins
+        },
+
+        webpackMiddleware: {
+            stats: 'errors-only'
        },

        browsers: ['PhantomJS']
    });
-}
+};
--- a/package.js
+++ b/package.js
@@ -2,8 +2,8 @@

 Package.describe({
  name: "zenorocha:clipboard",
-  summary: "Modern copy to clipboard. No Flash. Just 2kb.",
-  version: "1.5.8",
+  summary: "Modern copy to clipboard. No Flash. Just 3kb.",
+  version: "2.0.0",
  git: "https://github.com/zenorocha/clipboard.js"
 });

--- a/package.json
+++ b/package.json
@@ -1,45 +1,46 @@
 {
  "name": "clipboard",
-  "version": "1.5.8",
+  "version": "2.0.1",
  "description": "Modern copy to clipboard. No Flash. Just 2kb",
  "repository": "zenorocha/clipboard.js",
  "license": "MIT",
-  "main": "lib/clipboard.js",
+  "main": "dist/clipboard.js",
+  "module": "dist/clipboard.js",
  "keywords": [
    "clipboard",
    "copy",
    "cut"
  ],
  "dependencies": {
-    "good-listener": "^1.1.6",
-    "select": "^1.0.6",
-    "tiny-emitter": "^1.0.0"
+    "good-listener": "^1.2.2",
+    "select": "^1.1.2",
+    "tiny-emitter": "^2.0.0"
  },
  "devDependencies": {
-    "babel": "^5.8.29",
-    "babelify": "^6.3.0",
-    "bannerify": "Vekat/bannerify#feature-option",
-    "browserify": "^11.2.0",
+    "babel-cli": "^6.5.1",
+    "babel-core": "^6.5.2",
+    "babel-loader": "^6.2.10",
+    "babel-plugin-transform-es2015-modules-umd": "^6.5.0",
+    "babel-preset-es2015": "^6.5.0",
    "chai": "^3.4.1",
-    "karma": "^0.13.10",
-    "karma-browserify": "^4.4.0",
+    "cross-env": "^3.1.4",
+    "karma": "^1.3.0",
    "karma-chai": "^0.1.0",
-    "karma-mocha": "^0.2.0",
-    "karma-phantomjs-launcher": "^0.2.1",
+    "karma-mocha": "^1.2.0",
+    "karma-phantomjs-launcher": "^1.0.0",
    "karma-sinon": "^1.0.4",
-    "mocha": "^2.3.3",
-    "phantomjs": "^1.9.18",
-    "phantomjs-polyfill": "0.0.1",
+    "karma-webpack": "^2.0.2",
+    "mocha": "^3.1.2",
+    "phantomjs-prebuilt": "^2.1.4",
    "sinon": "^1.17.2",
-    "uglify-js": "^2.4.24",
-    "watchify": "^3.4.0"
+    "webpack": "^2.2.1"
  },
  "scripts": {
    "build": "npm run build-debug && npm run build-min",
-    "build-debug": "browserify src/clipboard.js -s Clipboard -t [babelify --loose all] -p [bannerify --file .banner ] -o dist/clipboard.js",
-    "build-min": "uglifyjs dist/clipboard.js --comments '/!/' -m screw_ie8=true -c screw_ie8=true,unused=false -o dist/clipboard.min.js",
-    "build-watch": "watchify src/clipboard.js -s Clipboard -t [babelify --loose all] -o dist/clipboard.js -v",
+    "build-debug": "webpack",
+    "build-min": "cross-env NODE_ENV=production webpack --optimize-minimize",
+    "build-watch": "webpack --watch",
    "test": "karma start --single-run",
-    "prepublish": "babel src --out-dir lib --loose all"
+    "prepublish": "npm run build"
  }
 }
--- a/readme.md
+++ b/readme.md
@@ -3,9 +3,9 @@
 [![Build Status](http://img.shields.io/travis/zenorocha/clipboard.js/master.svg?style=flat)](https://travis-ci.org/zenorocha/clipboard.js)
 ![Killing Flash](https://img.shields.io/badge/killing-flash-brightgreen.svg?style=flat)

-> Modern copy to clipboard. No Flash. Just 2kb
+> Modern copy to clipboard. No Flash. Just 3kb gzipped.

-<a href="http://clipboardjs.com/"><img width="728" src="https://cloud.githubusercontent.com/assets/398893/9983535/5ab0a950-5fb4-11e5-9602-e73c0b661883.jpg" alt="Demo"></a>
+<a href="https://clipboardjs.com/"><img width="728" src="https://cloud.githubusercontent.com/assets/398893/16165747/a0f6fc46-349a-11e6-8c9b-c5fd58d9099c.png" alt="Demo"></a>

 ## Why

@@ -21,13 +21,7 @@ You can get it on npm.
 npm install clipboard --save
 ```

-Or bower, too.
-
-```
-bower install clipboard --save
-```
-
-If you're not into package management, just [download a ZIP](https://github.com/zenorocha/clipboard.js/archive/master.zip) file.
+Or if you're not into package management, just [download a ZIP](https://github.com/zenorocha/clipboard.js/archive/master.zip) file.

 ## Setup

@@ -40,7 +34,7 @@ First, include the script located on the `dist` folder or load it from [a third-
 Now, you need to instantiate it by [passing a DOM selector](https://github.com/zenorocha/clipboard.js/blob/master/demo/constructor-selector.html#L18), [HTML element](https://github.com/zenorocha/clipboard.js/blob/master/demo/constructor-node.html#L16-L17), or [list of HTML elements](https://github.com/zenorocha/clipboard.js/blob/master/demo/constructor-nodelist.html#L18-L19).

 ```js
-new Clipboard('.btn');
+new ClipboardJS('.btn');
 ```

 Internally, we need to fetch all elements that matches with your selector and attach event listeners for each one. But guess what? If you have hundreds of matches, this operation can consume a lot of memory.
@@ -57,7 +51,7 @@ A pretty common use case is to copy content from another element. You can do tha

 The value you include on this attribute needs to match another's element selector.

-<a href="http://clipboardjs.com/#example-target"><img width="473" alt="example-2" src="https://cloud.githubusercontent.com/assets/398893/9983467/a4946aaa-5fb1-11e5-9780-f09fcd7ca6c8.png"></a>
+<a href="https://clipboardjs.com/#example-target"><img width="473" alt="example-2" src="https://cloud.githubusercontent.com/assets/398893/9983467/a4946aaa-5fb1-11e5-9780-f09fcd7ca6c8.png"></a>

 ```html
 <!-- Target -->
@@ -75,7 +69,7 @@ Additionally, you can define a `data-clipboard-action` attribute to specify if y

 If you omit this attribute, `copy` will be used by default.

-<a href="http://clipboardjs.com/#example-action"><img width="473" alt="example-3" src="https://cloud.githubusercontent.com/assets/398893/10000358/7df57b9c-6050-11e5-9cd1-fbc51d2fd0a7.png"></a>
+<a href="https://clipboardjs.com/#example-action"><img width="473" alt="example-3" src="https://cloud.githubusercontent.com/assets/398893/10000358/7df57b9c-6050-11e5-9cd1-fbc51d2fd0a7.png"></a>

 ```html
 <!-- Target -->
@@ -93,7 +87,7 @@ As you may expect, the `cut` action only works on `<input>` or `<textarea>` elem

 Truth is, you don't even need another element to copy its content from. You can just include a `data-clipboard-text` attribute in your trigger element.

-<a href="http://clipboardjs.com/#example-text"><img width="147" alt="example-1" src="https://cloud.githubusercontent.com/assets/398893/10000347/6e16cf8c-6050-11e5-9883-1c5681f9ec45.png"></a>
+<a href="https://clipboardjs.com/#example-text"><img width="147" alt="example-1" src="https://cloud.githubusercontent.com/assets/398893/10000347/6e16cf8c-6050-11e5-9883-1c5681f9ec45.png"></a>

 ```html
 <!-- Trigger -->
@@ -109,7 +103,7 @@ There are cases where you'd like to show some user feedback or capture what has
 That's why we fire custom events such as `success` and `error` for you to listen and implement your custom logic.

 ```js
-var clipboard = new Clipboard('.btn');
+var clipboard = new ClipboardJS('.btn');

 clipboard.on('success', function(e) {
    console.info('Action:', e.action);
@@ -125,7 +119,13 @@ clipboard.on('error', function(e) {
 });
 ```

-For a live demonstration, open this [site](http://clipboardjs.com/) and just your console :)
+For a live demonstration, go to this [site](https://clipboardjs.com/) and open your console.
+
+## Tooltips
+
+Each application has different design needs, that's why clipboard.js does not include any CSS or built-in tooltip solution.
+
+The tooltips you see on the [demo site](https://clipboardjs.com/) were built using [GitHub's Primer](https://github.com/primer/primer-css/tree/master/modules/primer-tooltips). You may want to check that out if you're looking for a similar look and feel.

 ## Advanced Options

@@ -134,7 +134,7 @@ If you don't want to modify your HTML, there's a pretty handy imperative API for
 For instance, if you want to dynamically set a `target`, you'll need to return a Node.

 ```js
-new Clipboard('.btn', {
+new ClipboardJS('.btn', {
    target: function(trigger) {
        return trigger.nextElementSibling;
    }
@@ -144,33 +144,45 @@ new Clipboard('.btn', {
 If you want to dynamically set a `text`, you'll return a String.

 ```js
-new Clipboard('.btn', {
+new ClipboardJS('.btn', {
    text: function(trigger) {
        return trigger.getAttribute('aria-label');
    }
 });
 ```

+For use in Bootstrap Modals or with any other library that changes the focus you'll want to set the focused element as the `container` value.
+
+```js
+new ClipboardJS('.btn', {
+    container: document.getElementById('modal')
+});
+```
+
 Also, if you are working with single page apps, you may want to manage the lifecycle of the DOM more precisely. Here's how you clean up the events and objects that we create.

 ```js
-var clipboard = new Clipboard('.btn');
+var clipboard = new ClipboardJS('.btn');
 clipboard.destroy();
 ```

 ## Browser Support

-This library relies on both [Selection](https://developer.mozilla.org/en-US/docs/Web/API/Selection) and [execCommand](https://developer.mozilla.org/en-US/docs/Web/API/Document/execCommand) APIs. The second one is supported in the following browsers.
+This library relies on both [Selection](https://developer.mozilla.org/en-US/docs/Web/API/Selection) and [execCommand](https://developer.mozilla.org/en-US/docs/Web/API/Document/execCommand) APIs. The first one is [supported by all browsers](http://caniuse.com/#search=selection) while the second one is supported in the following browsers.

-| <img src="http://clipboardjs.com/assets/images/chrome.png" width="48px" height="48px" alt="Chrome logo"> | <img src="http://clipboardjs.com/assets/images/firefox.png" width="48px" height="48px" alt="Firefox logo"> | <img src="http://clipboardjs.com/assets/images/ie.png" width="48px" height="48px" alt="Internet Explorer logo"> | <img src="http://clipboardjs.com/assets/images/opera.png" width="48px" height="48px" alt="Opera logo"> | <img src="http://clipboardjs.com/assets/images/safari.png" width="48px" height="48px" alt="Safari logo"> |
-|:---:|:---:|:---:|:---:|:---:|
-| 42+ ✔ | 41+ ✔ | 9+ ✔ | 29+ ✔ | Nope ✘ |
+| <img src="https://clipboardjs.com/assets/images/chrome.png" width="48px" height="48px" alt="Chrome logo"> | <img src="https://clipboardjs.com/assets/images/edge.png" width="48px" height="48px" alt="Edge logo"> | <img src="https://clipboardjs.com/assets/images/firefox.png" width="48px" height="48px" alt="Firefox logo"> | <img src="https://clipboardjs.com/assets/images/ie.png" width="48px" height="48px" alt="Internet Explorer logo"> | <img src="https://clipboardjs.com/assets/images/opera.png" width="48px" height="48px" alt="Opera logo"> | <img src="https://clipboardjs.com/assets/images/safari.png" width="48px" height="48px" alt="Safari logo"> |
+|:---:|:---:|:---:|:---:|:---:|:---:|
+| 42+ ✔ | 12+ ✔ | 41+ ✔ | 9+ ✔ | 29+ ✔ | 10+ ✔ |

-Although copy/cut operations with [execCommand](https://developer.mozilla.org/en-US/docs/Web/API/Document/execCommand) aren't supported on Safari yet (including mobile), it gracefully degrades because [Selection](https://developer.mozilla.org/en-US/docs/Web/API/Selection) is supported.
+The good news is that clipboard.js gracefully degrades if you need to support older browsers. All you have to do is show a tooltip saying `Copied!` when `success` event is called and `Press Ctrl+C to copy` when `error` event is called because the text is already selected.

-That means you can show a tooltip saying `Copied!` when `success` event is called and `Press Ctrl+C to copy` when `error` event is called because the text is already selected.
+You can also check if clipboard.js is supported or not by running `ClipboardJS.isSupported()`, that way you can hide copy/cut buttons from the UI.

-For a live demonstration, open this [site](http://clipboardjs.com) on Safari.
+## Bonus
+
+A browser extension that adds a "copy to clipboard" button to every code block on *GitHub, MDN, Gist, StackOverflow, StackExchange, npm, and even Medium.*
+
+Install for [Chrome](https://chrome.google.com/webstore/detail/codecopy/fkbfebkcoelajmhanocgppanfoojcdmg) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/codecopy/).

 ## License

--- a/src/clipboard-action.js
+++ b/src/clipboard-action.js
@@ -4,7 +4,7 @@ import select from 'select';
 * Inner class which performs selection from either `text` or `target`
 * properties and then executes copy or cut operations.
 */
-export default class ClipboardAction {
+class ClipboardAction {
    /**
     * @param {Object} options
     */
@@ -18,11 +18,12 @@ export default class ClipboardAction {
     * @param {Object} options
     */
    resolveOptions(options = {}) {
-        this.action  = options.action;
-        this.emitter = options.emitter;
-        this.target  = options.target;
-        this.text    = options.text;
-        this.trigger = options.trigger;
+        this.action    = options.action;
+        this.container = options.container;
+        this.emitter   = options.emitter;
+        this.target    = options.target;
+        this.text      = options.text;
+        this.trigger   = options.trigger;

        this.selectedText = '';
    }
@@ -32,18 +33,12 @@ export default class ClipboardAction {
     * on the existence of `text` and `target` properties.
     */
    initSelection() {
-        if (this.text && this.target) {
-            throw new Error('Multiple attributes declared, use either "target" or "text"');
-        }
-        else if (this.text) {
+        if (this.text) {
            this.selectFake();
        }
        else if (this.target) {
            this.selectTarget();
        }
-        else {
-            throw new Error('Missing required attributes, use either "target" or "text"');
-        }
    }

    /**
@@ -51,11 +46,12 @@ export default class ClipboardAction {
     * and makes a selection on it.
     */
    selectFake() {
-        let isRTL = document.documentElement.getAttribute('dir') == 'rtl';
+        const isRTL = document.documentElement.getAttribute('dir') == 'rtl';

        this.removeFake();

-        this.fakeHandler = document.body.addEventListener('click', () => this.removeFake());
+        this.fakeHandlerCallback = () => this.removeFake();
+        this.fakeHandler = this.container.addEventListener('click', this.fakeHandlerCallback) || true;

        this.fakeElem = document.createElement('textarea');
        // Prevent zooming on iOS
@@ -68,11 +64,13 @@ export default class ClipboardAction {
        this.fakeElem.style.position = 'absolute';
        this.fakeElem.style[ isRTL ? 'right' : 'left' ] = '-9999px';
        // Move element to the same position vertically
-        this.fakeElem.style.top = (window.pageYOffset || document.documentElement.scrollTop) + 'px';
+        let yPosition = window.pageYOffset || document.documentElement.scrollTop;
+        this.fakeElem.style.top = `${yPosition}px`;
+
        this.fakeElem.setAttribute('readonly', '');
        this.fakeElem.value = this.text;

-        document.body.appendChild(this.fakeElem);
+        this.container.appendChild(this.fakeElem);

        this.selectedText = select(this.fakeElem);
        this.copyText();
@@ -84,12 +82,13 @@ export default class ClipboardAction {
     */
    removeFake() {
        if (this.fakeHandler) {
-            document.body.removeEventListener('click');
+            this.container.removeEventListener('click', this.fakeHandlerCallback);
            this.fakeHandler = null;
+            this.fakeHandlerCallback = null;
        }

        if (this.fakeElem) {
-            document.body.removeChild(this.fakeElem);
+            this.container.removeChild(this.fakeElem);
            this.fakeElem = null;
        }
    }
@@ -123,29 +122,20 @@ export default class ClipboardAction {
     * @param {Boolean} succeeded
     */
    handleResult(succeeded) {
-        if (succeeded) {
-            this.emitter.emit('success', {
-                action: this.action,
-                text: this.selectedText,
-                trigger: this.trigger,
-                clearSelection: this.clearSelection.bind(this)
-            });
-        }
-        else {
-            this.emitter.emit('error', {
-                action: this.action,
-                trigger: this.trigger,
-                clearSelection: this.clearSelection.bind(this)
-            });
-        }
+        this.emitter.emit(succeeded ? 'success' : 'error', {
+            action: this.action,
+            text: this.selectedText,
+            trigger: this.trigger,
+            clearSelection: this.clearSelection.bind(this)
+        });
    }

    /**
-     * Removes current selection and focus from `target` element.
+     * Moves focus away from `target` and back to the trigger, removes current selection.
     */
    clearSelection() {
-        if (this.target) {
-            this.target.blur();
+        if (this.trigger) {
+            this.trigger.focus();
        }

        window.getSelection().removeAllRanges();
@@ -179,6 +169,14 @@ export default class ClipboardAction {
    set target(target) {
        if (target !== undefined) {
            if (target && typeof target === 'object' && target.nodeType === 1) {
+                if (this.action === 'copy' && target.hasAttribute('disabled')) {
+                    throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');
+                }
+
+                if (this.action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {
+                    throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes');
+                }
+
                this._target = target;
            }
            else {
@@ -202,3 +200,5 @@ export default class ClipboardAction {
        this.removeFake();
    }
 }
+
+module.exports = ClipboardAction;
--- a/src/clipboard.js
+++ b/src/clipboard.js
@@ -6,7 +6,7 @@ import listen from 'good-listener';
 * Base class which takes one or more elements, adds event listeners to them,
 * and instantiates a new `ClipboardAction` on each click.
 */
-export default class Clipboard extends Emitter {
+class Clipboard extends Emitter {
    /**
     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger
     * @param {Object} options
@@ -24,9 +24,10 @@ export default class Clipboard extends Emitter {
     * @param {Object} options
     */
    resolveOptions(options = {}) {
-        this.action = (typeof options.action === 'function') ? options.action : this.defaultAction;
-        this.target = (typeof options.target === 'function') ? options.target : this.defaultTarget;
-        this.text   = (typeof options.text   === 'function') ? options.text   : this.defaultText;
+        this.action    = (typeof options.action    === 'function') ? options.action    : this.defaultAction;
+        this.target    = (typeof options.target    === 'function') ? options.target    : this.defaultTarget;
+        this.text      = (typeof options.text      === 'function') ? options.text      : this.defaultText;
+        this.container = (typeof options.container === 'object')   ? options.container : document.body;
    }

    /**
@@ -42,18 +43,19 @@ export default class Clipboard extends Emitter {
     * @param {Event} e
     */
    onClick(e) {
-        let trigger = e.delegateTarget || e.currentTarget;
+        const trigger = e.delegateTarget || e.currentTarget;

        if (this.clipboardAction) {
            this.clipboardAction = null;
        }

        this.clipboardAction = new ClipboardAction({
-            action  : this.action(trigger),
-            target  : this.target(trigger),
-            text    : this.text(trigger),
-            trigger : trigger,
-            emitter : this
+            action    : this.action(trigger),
+            target    : this.target(trigger),
+            text      : this.text(trigger),
+            container : this.container,
+            trigger   : trigger,
+            emitter   : this
        });
    }

@@ -70,13 +72,29 @@ export default class Clipboard extends Emitter {
     * @param {Element} trigger
     */
    defaultTarget(trigger) {
-        let selector = getAttributeValue('target', trigger);
+        const selector = getAttributeValue('target', trigger);

        if (selector) {
            return document.querySelector(selector);
        }
    }

+    /**
+     * Returns the support of the given action, or all actions if no action is
+     * given.
+     * @param {String} [action]
+     */
+    static isSupported(action = ['copy', 'cut']) {
+        const actions = (typeof action === 'string') ? [action] : action;
+        let support = !!document.queryCommandSupported;
+
+        actions.forEach((action) => {
+            support = support && !!document.queryCommandSupported(action);
+        });
+
+        return support;
+    }
+
    /**
     * Default `text` lookup function.
     * @param {Element} trigger
@@ -105,7 +123,7 @@ export default class Clipboard extends Emitter {
 * @param {Element} element
 */
 function getAttributeValue(suffix, element) {
-    let attribute = `data-clipboard-${suffix}`;
+    const attribute = `data-clipboard-${suffix}`;

    if (!element.hasAttribute(attribute)) {
        return;
@@ -113,3 +131,5 @@ function getAttributeValue(suffix, element) {

    return element.getAttribute(attribute);
 }
+
+module.exports = Clipboard;
--- a/test/clipboard-action.js
+++ b/test/clipboard-action.js
@@ -22,10 +22,12 @@ describe('ClipboardAction', () => {
        it('should set base properties', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                text: 'foo'
            });

            assert.property(clip, 'action');
+            assert.property(clip, 'container');
            assert.property(clip, 'emitter');
            assert.property(clip, 'target');
            assert.property(clip, 'text');
@@ -35,35 +37,13 @@ describe('ClipboardAction', () => {
    });

    describe('#initSelection', () => {
-        it('should throw an error since both "text" and "target" were passed', done => {
-            try {
-                new ClipboardAction({
-                    text: 'foo',
-                    target: document.querySelector('#input')
-                });
-            }
-            catch(e) {
-                assert.equal(e.message, 'Multiple attributes declared, use either "target" or "text"');
-                done();
-            }
-        });
-
-        it('should throw an error since neither "text" nor "target" were passed', done => {
-            try {
-                new ClipboardAction();
-            }
-            catch(e) {
-                assert.equal(e.message, 'Missing required attributes, use either "target" or "text"');
-                done();
-            }
-        });
-
        it('should set the position right style property', done => {
            // Set document direction
            document.documentElement.setAttribute('dir', 'rtl');

            let clip = new ClipboardAction({
                    emitter: new Emitter(),
+                    container: document.body,
                    text: 'foo'
                });

@@ -105,6 +85,7 @@ describe('ClipboardAction', () => {
        it('should create a fake element and select its value', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                text: 'blah'
            });

@@ -116,6 +97,7 @@ describe('ClipboardAction', () => {
        it('should remove a temporary fake element', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                text: 'blah'
            });

@@ -129,6 +111,7 @@ describe('ClipboardAction', () => {
        it('should select text from editable element', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                target: document.querySelector('#input')
            });

@@ -138,6 +121,7 @@ describe('ClipboardAction', () => {
        it('should select text from non-editable element', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                target: document.querySelector('#paragraph')
            });

@@ -164,7 +148,7 @@ describe('ClipboardAction', () => {
            });

            let clip = new ClipboardAction({
-                emitter: emitter,
+                emitter,
                target: document.querySelector('#input')
            });
        });
@@ -179,7 +163,7 @@ describe('ClipboardAction', () => {
            });

            let clip = new ClipboardAction({
-                emitter: emitter,
+                emitter,
                target: document.querySelector('#input')
            });
        });
@@ -189,6 +173,7 @@ describe('ClipboardAction', () => {
        it('should fire a success event with certain properties', done => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                target: document.querySelector('#input')
            });

@@ -207,6 +192,7 @@ describe('ClipboardAction', () => {
        it('should fire a error event with certain properties', done => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                target: document.querySelector('#input')
            });

@@ -226,6 +212,7 @@ describe('ClipboardAction', () => {
        it('should remove focus from target and text selection', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                target: document.querySelector('#input')
            });

@@ -243,6 +230,7 @@ describe('ClipboardAction', () => {
        it('should destroy an existing fake element', () => {
            let clip = new ClipboardAction({
                emitter: new Emitter(),
+                container: document.body,
                text: 'blah'
            });

--- a/test/clipboard.js
+++ b/test/clipboard.js
@@ -26,7 +26,7 @@ describe('Clipboard', () => {

    describe('#resolveOptions', () => {
        before(() => {
-            global.fn = function() {};
+            global.fn = () => {};
        });

        it('should set action as a function', () => {
@@ -52,6 +52,20 @@ describe('Clipboard', () => {

            assert.equal(global.fn, clipboard.text);
        });
+
+        it('should set container as an object', () => {
+            let clipboard = new Clipboard('.btn', {
+                container: document.body
+            });
+
+            assert.equal(document.body, clipboard.container);
+        });
+
+        it('should set container as body by default', () => {
+            let clipboard = new Clipboard('.btn');
+
+            assert.equal(document.body, clipboard.container);
+        });
    });

    describe('#listenClick', () => {
@@ -79,8 +93,8 @@ describe('Clipboard', () => {

        it('should throw an exception when target is invalid', done => {
            try {
-                var clipboard = new Clipboard('.btn', {
-                    target: function() {
+                const clipboard = new Clipboard('.btn', {
+                    target() {
                        return null;
                    }
                });
@@ -94,6 +108,17 @@ describe('Clipboard', () => {
        });
    });

+    describe('#static isSupported', () => {
+        it('should return the support of the given action', () => {
+            assert.equal(Clipboard.isSupported('copy'), false);
+            assert.equal(Clipboard.isSupported('cut'), false);
+        });
+
+        it('should return the support of the cut and copy actions', () => {
+            assert.equal(Clipboard.isSupported(), false);
+        });
+    });
+
    describe('#destroy', () => {
        it('should destroy an existing instance of ClipboardAction', () => {
            let clipboard = new Clipboard('.btn');
--- a/webpack.config.js
+++ b/webpack.config.js
@@ -0,0 +1,41 @@
+const pkg = require('./package.json');
+const path = require('path');
+const webpack = require('webpack');
+
+const production = process.env.NODE_ENV === 'production' || false;
+
+const banner = `clipboard.js v${pkg.version}
+https://zenorocha.github.io/clipboard.js
+
+Licensed MIT © Zeno Rocha`;
+
+module.exports = {
+    entry: './src/clipboard.js',
+    output: {
+        filename: production ? 'clipboard.min.js' : 'clipboard.js',
+        path: path.resolve(__dirname, 'dist'),
+        library: 'ClipboardJS',
+        libraryTarget: 'umd'
+    },
+    module: {
+        rules: [
+            {test: /\.js$/, exclude: /node_modules/, loader: 'babel-loader'}
+        ]
+    },
+    plugins: production ? [
+            new webpack.optimize.UglifyJsPlugin({
+                beautify: false,
+                mangle: {
+                    screw_ie8: true,
+                    keep_fnames: true
+                },
+                compress: {
+                    screw_ie8: true
+                },
+                comments: false
+            }),
+            new webpack.BannerPlugin({banner})
+        ] : [
+            new webpack.BannerPlugin({banner})
+        ]
+};
Author	SHA1	Message	Date
Zeno Rocha	3382ea3d14	2.0.1	2018-04-29 16:41:13 -07:00
Paweł Lesiecki	0fcf8c9460	Update package.json (#532 ) Correct module path	2018-04-29 16:14:20 -07:00
Zeno Rocha	e1d571b3f3	Updates docs to use ClipboardJS 2.0	2018-03-01 09:07:10 -08:00
Zeno Rocha	43beb07bac	Release v2.0.0	2018-02-28 21:56:32 -08:00
Zeno Rocha	9086f3ed64	Updates demos to use new constructor	2018-02-28 21:46:48 -08:00
Zeno Rocha	750cf124d7	Changes global variable from "Clipboard" to "ClipboardJS" This was introduced in order to prevent a name conflict with the new `window.Clipboard` native function For more info check: * https://w3c.github.io/clipboard-apis/ * `ac319a7ed3`	2018-02-28 21:45:59 -08:00
Zeno Rocha	d25dcac817	Migrates banner from Browserify to Webpack #372	2018-02-28 20:32:25 -08:00
Fernando Herrero	f7e2f58c96	Create composer.json for instalation with composer (#467 ) * Create composer.json for instalation with composer The installation is much simpler with Composer and https://github.com/RobLoach/component-installer After merged you can test it: ``` composer config repositories.zenorocha-clipboardjs vcs "https://github.com/zenorocha/clipboard.js/" composer require zenorocha-clipboardjs:dev-master ``` Before merged you can test using my git fork. Composer creates a "components" folder that contains the "clipboardjs" whith all files spec in "files" of composer.json. You can then register the "package" at https://packagist.org In this way the installation would be simpler: `composer require zenorocha-clipboardjs:dev-master` * Remove icon	2018-02-28 17:05:21 -08:00
Guillaume Vincent	2d5b2df811	Migrate from Browserify to Webpack (#372 ) * Migrate from Browserify to Webpack close https://github.com/zenorocha/clipboard.js/issues/371 Author: Guillaume Vincent <guillaume@oslab.fr> * remove browserify and associated modules and update tests	2018-02-28 17:03:39 -08:00
Lucas Bento	0c3bce265f	Fix GitHub Primer tooltips link (#479 )	2017-10-16 07:25:57 -07:00
Zeno Rocha	3c0dfe5a38	Adds docs on tooltips #423	2017-06-30 16:30:30 -03:00
Nathan	f960b0d20a	use only ID name for DOM (#431 )	2017-06-30 15:52:07 -03:00
Zeno Rocha	b6e6b80ab0	Release v1.7.1	2017-05-29 16:57:52 -07:00
Patrick H. Lauke	a55c9ac513	Move focus to trigger instead of simply blur()ing (#419 ) blur() results in a loss/reset of keyboard focus, meaning keyboard users usually get thrown right back to the start of the page. Instead, this moves focus back to the trigger (which had the focus when the trigger was activated). As with the proposed fix in https://github.com/zenorocha/clipboard.js/pull/418 this obviously results in the focus styles (like the default outline, unless suppressed) being applied to the trigger (see the related PR for rationale and future fix using `:focus-ring`)	2017-05-29 16:54:55 -07:00
Zeno Rocha	39e622456c	Release v1.7.0	2017-05-29 14:43:41 -07:00
Zeno Rocha	f8c322f163	Reviews text from #368	2017-05-29 14:20:36 -07:00
Peder Johnsen	f42b57067d	Container option (#368 ) * Allow container option to fix bugs related to bootstrap modals etc. * Updated readme to reflect addition of container option * Name link * Removed test log * Remove unwanted whitespace * Refactored description	2017-05-29 14:17:26 -07:00
Zeno Rocha	4065080a17	Removes bower notes from docs	2017-05-22 13:31:36 -07:00
Gabriel Kalani	5ab50475e0	ES6 refactor (#409 ) * little fix * little fix /2 * test/clipboard.js refactored * emitter: emitter --> emitter * Examples in ES6 * es6 * back to original code * script > npm test * script > npm test not necessary * updating modules * removing export default	2017-05-02 21:34:18 -07:00
Zeno Rocha	e1394b3b8c	Adds bonus section	2017-05-01 09:17:35 -07:00
Zeno Rocha	f59d4e6b4d	Release v1.6.1	2017-02-28 09:58:40 -08:00
Zeno Rocha	9ddff7e591	Prevents Node env from throwing an error	2017-02-28 09:57:36 -08:00
Zeno Rocha	a00f1fe327	Release v1.6.0	2017-02-08 00:02:14 -08:00
Zeno Rocha	38ae5b34f3	Adds documentation about #355	2017-02-07 23:59:27 -08:00
Zeno Rocha	41b7234d50	Prevents keyboard from opening on iOS when using "data-clipboard-target"	2017-02-07 23:41:46 -08:00
Zeno Rocha	3696739e5e	Prevents scroll jump on iOS when using "data-clipboard-text" Thanks to @geraldarthur at #369	2017-02-07 23:37:43 -08:00
Itai Steinherz	63d1b0f014	Add isSupported method #355	2017-02-07 23:36:29 -08:00
Zeno Rocha	402c9ee17b	Release v1.5.16	2016-12-12 11:54:35 -02:00
Zeno Rocha	0538f6e212	Ensures that event delegation works with multiple documents (a page with iframes)	2016-12-12 11:53:41 -02:00
Zeno Rocha	8ad16a2c6c	Release v1.5.15	2016-10-22 19:44:43 -07:00
Zeno Rocha	ce0829054b	Updates dev dependencies	2016-10-22 19:37:37 -07:00
Zeno Rocha	223d30c110	Removes babel loose mode	2016-10-22 19:37:18 -07:00
Zeno Rocha	b1a68df6e9	Release v1.5.14	2016-10-22 19:36:49 -07:00
Zeno Rocha	0149e1de5e	Updates good-listener package which removes two dependencies	2016-10-22 19:10:44 -07:00
Zeno Rocha	26a9e9d56c	Release v1.5.13	2016-10-16 22:44:03 -07:00
Zeno Rocha	fce625f151	Fixes #320	2016-10-16 18:53:34 -07:00
Zeno Rocha	f7040bae8a	Adds meta viewport for all demos	2016-10-16 17:16:02 -07:00
Zeno Rocha	9f9d03c927	Adds Edge version #316	2016-09-26 13:57:28 -05:00
Cătălin Mariș	e18c26ae07	Add `Edge` to the `Browser Support` section (#316 ) Ref: https://github.com/zenorocha/clipboard.js/pull/267#issuecomment-249620994	2016-09-26 13:48:16 -05:00
Zeno Rocha	70cfabec69	Update readme.md	2016-09-21 13:21:25 -07:00
Zeno Rocha	f700a1b12e	Moves URLs to HTTPS	2016-09-21 11:42:37 -07:00
Zeno Rocha	9e3d662c4e	Adjusts text based on #313	2016-09-21 11:04:07 -07:00
JY Kim	76b907949c	issue #282 solution (#283 ) * add selectedText * better code * remove dist folder * Revert "remove dist folder" This reverts commit `50e726c7a7`. * orogin dist source	2016-09-08 08:57:41 -07:00
Zeno Rocha	60b6887100	Updates site preview	2016-06-17 14:49:39 -07:00
Zeno Rocha	eb7418b51b	Release v1.5.12	2016-06-09 07:57:20 -07:00
Alexander	869c4e3219	Fix bug that unable to remove fake event listener (#256 ) * Fix bug that unable to remove fake event listener * Update dist	2016-06-09 07:54:07 -07:00
Zeno Rocha	a4ab305297	Release v1.5.11	2016-06-08 21:46:20 -07:00
Zeno Rocha	294e9fcb5d	Fix fake element position from "fixed" to "absolute" #194 #250	2016-06-08 21:44:54 -07:00
Ali Bozorgkhan	79c3361ca4	Press Ctrl+C to copy -> Press Command+C to copy (#252 ) As Safari users are mostly using mac, coping a text needs Command+C instead of Ctrl+C	2016-06-02 15:28:16 -07:00
grabus	c3fefc1fc0	Fix memory leak because of fakeHandlers (#243 ) addEventListener always returns undefined by spec https://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-EventTarget-addEventListener	2016-05-26 11:35:18 -07:00
Zeno Rocha	42bd266f0b	Adds basic JSFiddle to help people reproduce their bugs	2016-05-01 16:14:51 -07:00
Zeno Rocha	53a733fcb5	Release v1.5.10	2016-04-03 22:33:02 -07:00
Zeno Rocha	7a5a910bcd	Removes error message when target/text attributes are null, undefined, or false	2016-04-03 22:16:22 -07:00
Zeno Rocha	0163f7cb72	Merge pull request #216 from sebastianekstrom/master Use const instead of let when applicable	2016-04-01 08:48:49 -07:00
Sebastian Ekström	941bdbb16e	Use const instead of let when applicable	2016-04-01 13:17:12 +02:00
Zeno Rocha	00d5cc4e96	Updates tagline #210	2016-03-17 09:12:23 -07:00
Zeno Rocha	07a1f8456b	Throws error when disabled or readonly attributes are used on target element Fixes #41	2016-03-01 15:38:25 -08:00
Zeno Rocha	ff3cd2c722	Release v1.5.9	2016-02-26 10:26:32 -08:00
Zeno Rocha	d346f30e5d	Merge pull request #190 from heldr/master update modules and fix #176	2016-02-25 12:19:22 -08:00
Helder Santana	e5fe34c524	WTF?! npm	2016-02-25 15:17:07 -05:00
Zeno Rocha	0a6aace544	Merge pull request #194 from stepancar/patch-1 minor fix for fake elem	2016-02-25 12:06:38 -08:00
Stepan Mikhaylyuk	43d9c11aaf	minor fix for fake elem after call clipboard all page scrolls down. As i understand, its relates to fake element, cause its append to body. I just set position to 'fixed' and now it works right. I think 'fixed' is more css-style independence then 'absolute'	2016-02-25 15:20:13 +03:00
Helder Santana	90a52149ed	fix babel 6 export default behaviour	2016-02-20 01:41:40 -05:00
Helder Santana	83b9d6a84d	update modules and fix #176	2016-02-20 01:14:33 -05:00
Zeno Rocha	3d13baa385	Adds issue template	2016-02-18 11:40:00 -08:00