clipboard-rails 1.3.1.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b4c164f67d3b02062ff36276e5ac0d5885ec745f
-  data.tar.gz: 7d6720a4a790b98163283670792f98f114fea518
+  metadata.gz: 7adecfec979b0797c27dc425c3de4195849e77e4
+  data.tar.gz: 1d89fbbb306cafb7628f6507c91a8c6dedfc7839
 SHA512:
-  metadata.gz: 28262a8002e5f7c506ab13df15904a7063c2748c752a9a7039c3ccb0b178423f3fd839eca548d2b81317e66f7989e760bdd9cf93f4d06dee083cff8b1ebd88e4
-  data.tar.gz: 601422e8a78fdac820ecc331f74b030a0b817e888de1d6850ad04dc60d3b788d379abf34bdabe4a241ed959260a2f600a28971a76516621d7783c003efd299cf
+  metadata.gz: 1cd6b859d27a015fd064e882b56d2e41eae9dbedf1ba393af25b9ddc60c871d6bc447c1ece687b18d84e1614f5c0d2885a8404629e88134afd3d3a87de7eaa71
+  data.tar.gz: 45a8f9a8b016983bc7544dc0bb9bba13250f3b5379b5fa0071e623bd70e9eecc0e46148dc03645adb0199d9510cd57806d10a8dca5989bab4ed855f9ddc2ab6b

data/README.md

@@ -1,4 +1,5 @@
 # clipboard-rails
+[![Gem Version](https://badge.fury.io/rb/clipboard-rails.svg)](http://badge.fury.io/rb/clipboard-rails)
 
 clipboard-rails gem is the integration of clipboard.js javascript library for your Rails 4 application.
 
@@ -28,6 +29,35 @@ Now you need to edit your `app/assets/javascripts/application.js` file and add t
 
 ## Usage
 
+Here is the example working code to test with your Rails application.
+
+Add this sample code to your `app/assets/javascripts/application.js` file
+
+``` javascript
+$(document).ready(function(){  
+  
+  var clip = new Clipboard('.btn');
+  console.log(clip);
+	
+});
+```
+
+*Note:* Here i am using `gem 'jquery-turbolinks'` for using the jquery $(document).ready function 
+
+Add this sample code to your template file like `index.html.erb`
+
+``` html
+<!-- Target -->
+<textarea id="bar">Mussum ipsum cacilds...</textarea>
+
+<!-- Trigger -->
+<button class="btn" data-clipboard-action="cut" data-clipboard-target="#bar">
+    Cut to clipboard
+</button>
+```
+
+## Full documentation 
+
 Read the clipboard.js documentation here http://zenorocha.github.io/clipboard.js/
 
 ## Development

data/lib/clipboard/rails/version.rb

@@ -1,5 +1,5 @@
 module Clipboard
   module Rails
-    VERSION = "1.3.1.1"
+    VERSION = "1.4.0"
   end
 end

data/vendor/assets/javascripts/clipboard.js

@@ -51,57 +51,57 @@ exports.unbind = function(el, type, fn, capture){
 };
 
 },{"closest":2,"component-event":4}],2:[function(require,module,exports){
-var matches = require('matches-selector')
-
-module.exports = function (element, selector, checkYoSelf) {
-  var parent = checkYoSelf ? element : element.parentNode
-
-  while (parent && parent !== document) {
-    if (matches(parent, selector)) return parent;
-    parent = parent.parentNode
-  }
-}
+var matches = require('matches-selector')
+
+module.exports = function (element, selector, checkYoSelf) {
+  var parent = checkYoSelf ? element : element.parentNode
+
+  while (parent && parent !== document) {
+    if (matches(parent, selector)) return parent;
+    parent = parent.parentNode
+  }
+}
 
 },{"matches-selector":3}],3:[function(require,module,exports){
-
-/**
- * Element prototype.
- */
-
-var proto = Element.prototype;
-
-/**
- * Vendor function.
- */
-
-var vendor = proto.matchesSelector
-  || proto.webkitMatchesSelector
-  || proto.mozMatchesSelector
-  || proto.msMatchesSelector
-  || proto.oMatchesSelector;
-
-/**
- * Expose `match()`.
- */
-
-module.exports = match;
-
-/**
- * Match `el` to `selector`.
- *
- * @param {Element} el
- * @param {String} selector
- * @return {Boolean}
- * @api public
- */
-
-function match(el, selector) {
-  if (vendor) return vendor.call(el, selector);
-  var nodes = el.parentNode.querySelectorAll(selector);
-  for (var i = 0; i < nodes.length; ++i) {
-    if (nodes[i] == el) return true;
-  }
-  return false;
+
+/**
+ * Element prototype.
+ */
+
+var proto = Element.prototype;
+
+/**
+ * Vendor function.
+ */
+
+var vendor = proto.matchesSelector
+  || proto.webkitMatchesSelector
+  || proto.mozMatchesSelector
+  || proto.msMatchesSelector
+  || proto.oMatchesSelector;
+
+/**
+ * Expose `match()`.
+ */
+
+module.exports = match;
+
+/**
+ * Match `el` to `selector`.
+ *
+ * @param {Element} el
+ * @param {String} selector
+ * @return {Boolean}
+ * @api public
+ */
+
+function match(el, selector) {
+  if (vendor) return vendor.call(el, selector);
+  var nodes = el.parentNode.querySelectorAll(selector);
+  for (var i = 0; i < nodes.length; ++i) {
+    if (nodes[i] == el) return true;
+  }
+  return false;
 }
 },{}],4:[function(require,module,exports){
 var bind = window.addEventListener ? 'addEventListener' : 'attachEvent',
@@ -141,12 +141,12 @@ exports.unbind = function(el, type, fn, capture){
 };
 },{}],5:[function(require,module,exports){
 function E () {
-	// Keep this empty so it's easier to inherit from
+  // Keep this empty so it's easier to inherit from
   // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)
 }
 
 E.prototype = {
-	on: function (name, callback, ctx) {
+  on: function (name, callback, ctx) {
     var e = this.e || (this.e = {});
     
     (e[name] || (e[name] = [])).push({
@@ -265,7 +265,7 @@ var ClipboardAction = (function () {
     };
 
     /**
-     * Creates a fake input element, sets its value from `text` property,
+     * Creates a fake textarea element, sets its value from `text` property,
      * and makes a selection on it.
      */
 
@@ -278,9 +278,10 @@ var ClipboardAction = (function () {
             return _this.removeFake();
         });
 
-        this.fakeElem = document.createElement('input');
+        this.fakeElem = document.createElement('textarea');
         this.fakeElem.style.position = 'absolute';
         this.fakeElem.style.left = '-9999px';
+        this.fakeElem.style.top = document.body.scrollTop + 'px';
         this.fakeElem.setAttribute('readonly', '');
         this.fakeElem.value = this.text;
         this.selectedText = this.text;
@@ -383,6 +384,14 @@ var ClipboardAction = (function () {
      * @param {String} action
      */
 
+    /**
+     * Destroy lifecycle.
+     */
+
+    ClipboardAction.prototype.destroy = function destroy() {
+        this.removeFake();
+    };
+
     _createClass(ClipboardAction, [{
         key: 'action',
         set: function set() {
@@ -458,8 +467,6 @@ var _tinyEmitter = require('tiny-emitter');
 
 var _tinyEmitter2 = _interopRequireDefault(_tinyEmitter);
 
-var prefix = 'data-clipboard-';
-
 /**
  * Base class which takes a selector, delegates a click event to it,
  * and instantiates a new `ClipboardAction` on each click.
@@ -482,6 +489,12 @@ var Clipboard = (function (_Emitter) {
         this.delegateClick(selector);
     }
 
+    /**
+     * Helper function to retrieve attribute value.
+     * @param {String} suffix
+     * @param {Element} element
+     */
+
     /**
      * Defines if attributes would be resolved using internal setter functions
      * or custom functions that were passed in the constructor.
@@ -491,9 +504,9 @@ var Clipboard = (function (_Emitter) {
     Clipboard.prototype.resolveOptions = function resolveOptions() {
         var options = arguments.length <= 0 || arguments[0] === undefined ? {} : arguments[0];
 
-        this.action = typeof options.action === 'function' ? options.action : this.setAction;
-        this.target = typeof options.target === 'function' ? options.target : this.setTarget;
-        this.text = typeof options.text === 'function' ? options.text : this.setText;
+        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;
     };
 
     /**
@@ -504,17 +517,26 @@ var Clipboard = (function (_Emitter) {
     Clipboard.prototype.delegateClick = function delegateClick(selector) {
         var _this = this;
 
-        _delegateEvents2['default'].bind(document.body, selector, 'click', function (e) {
-            return _this.initialize(e);
+        this.binding = _delegateEvents2['default'].bind(document.body, selector, 'click', function (e) {
+            return _this.onClick(e);
         });
     };
 
+    /**
+     * Undelegates a click event on body.
+     * @param {String} selector
+     */
+
+    Clipboard.prototype.undelegateClick = function undelegateClick() {
+        _delegateEvents2['default'].unbind(document.body, 'click', this.binding);
+    };
+
     /**
      * Defines a new `ClipboardAction` on each click event.
      * @param {Event} e
      */
 
-    Clipboard.prototype.initialize = function initialize(e) {
+    Clipboard.prototype.onClick = function onClick(e) {
         if (this.clipboardAction) {
             this.clipboardAction = null;
         }
@@ -529,48 +551,62 @@ var Clipboard = (function (_Emitter) {
     };
 
     /**
-     * Sets the `action` lookup function.
+     * Default `action` lookup function.
      * @param {Element} trigger
      */
 
-    Clipboard.prototype.setAction = function setAction(trigger) {
-        if (!trigger.hasAttribute(prefix + 'action')) {
-            return;
-        }
-
-        return trigger.getAttribute(prefix + 'action');
+    Clipboard.prototype.defaultAction = function defaultAction(trigger) {
+        return getAttributeValue('action', trigger);
     };
 
     /**
-     * Sets the `target` lookup function.
+     * Default `target` lookup function.
      * @param {Element} trigger
      */
 
-    Clipboard.prototype.setTarget = function setTarget(trigger) {
-        if (!trigger.hasAttribute(prefix + 'target')) {
-            return;
-        }
+    Clipboard.prototype.defaultTarget = function defaultTarget(trigger) {
+        var selector = getAttributeValue('target', trigger);
 
-        var target = trigger.getAttribute(prefix + 'target');
-        return document.querySelector(target);
+        if (selector) {
+            return document.querySelector(selector);
+        }
     };
 
     /**
-     * Sets the `text` lookup function.
+     * Default `text` lookup function.
      * @param {Element} trigger
      */
 
-    Clipboard.prototype.setText = function setText(trigger) {
-        if (!trigger.hasAttribute(prefix + 'text')) {
-            return;
-        }
+    Clipboard.prototype.defaultText = function defaultText(trigger) {
+        return getAttributeValue('text', trigger);
+    };
 
-        return trigger.getAttribute(prefix + 'text');
+    /**
+     * Destroy lifecycle.
+     */
+
+    Clipboard.prototype.destroy = function destroy() {
+        this.undelegateClick();
+
+        if (this.clipboardAction) {
+            this.clipboardAction.destroy();
+            this.clipboardAction = null;
+        }
     };
 
     return Clipboard;
 })(_tinyEmitter2['default']);
 
+function getAttributeValue(suffix, element) {
+    var attribute = 'data-clipboard-' + suffix;
+
+    if (!element.hasAttribute(attribute)) {
+        return;
+    }
+
+    return element.getAttribute(attribute);
+}
+
 exports['default'] = Clipboard;
 module.exports = exports['default'];
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clipboard-rails
 version: !ruby/object:Gem::Version
-  version: 1.3.1.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Mohammed Sadiq
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-30 00:00:00.000000000 Z
+date: 2015-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler