Skip to content

MoralistFestus/ClipLab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLIPLAB LIBRARY - JavaScript

ClipLab

ClipLab is a Simple but Effective Copy to Clipboard 📋 Library ♎. This simple library allows copying text to clipboard with a single JavaScript function.

How to Use

✔ Download or Clone this Library
✔ Link it in your html file using <script src="cliplab.js"></script> or use the minified version.

CDN

https://cdn.jsdelivr.net/gh/MoralistFestus/ClipLab/src/cliplab.js

Or minifed version

https://cdn.jsdelivr.net/gh/MoralistFestus/ClipLab/src/cliplab.min.js

By tagged version

https://cdn.jsdelivr.net/gh/MoralistFestus/ClipLab@1.0.0/src/cliplab.js

https://cdn.jsdelivr.net/gh/MoralistFestus/ClipLab@1.0.0/src/cliplab.min.js

Example Code

new ClipLab()

This simple function triggers the copy to clipboard 📋 action.

ClipLab Attribute 📋

The ClipLab Js library has two data attributes:

  • data-copy-text
  • data-attr-selector

The two data attributes in cliplab are used for specifying clipboard value (text to be copied to clipboard).

  • The data-copy-text holds the text value to be copied to clipboard, while
  • The data-attr-selector points to the class or id value of an input field to be copied.

data-copy-text example

<button id="btn" data-copy-text="This text will be copied">Copy</button>

The data-copy-text attribute holds the text that will be copied to clipboard. To further copy the text to clipboard. let's call the ClipLab function and pass the id="btn" attribute into the function.

Sample code

<button id="btn" data-copy-text="This text will be copied">Copy text</button>
<script>
 new ClipLab("#btn"); // btn attribute
</script>

Once the copy text button is clicked, the text is copied.

You can let the user aware that the text is successfully copied to clipboard.

	<button id="btn" data-copy-text="The text will be copied">Copy text</button>
	
	<script type="text/javascript">
	var copyText = new ClipLab("#btn"); 
		var copyText = new ClipLab("#btn"); 
          // true
		copyText.onCopied = function(copied) {
			alert("Copied: " + copied);
		};
          // false
		copyText.notCopied = function(copied) {
			window.prompt("Ctrl+C: ", copied);
		}; 
	</script>

Texts from input or textarea fields can be copied with use of ClipLab library.

<input class="input" value="Press Copy to copy this text"></input>
	<button id="btn" data-attr-selector=".input">Copy</button>
	<script type="text/javascript">
		var copyText = new ClipLab("#btn");

		copyText.onCopied = function(copy) {
			alert("Copied: " + copy)
			this.unselect();
		};

		copyText.notCopied = function(copy) {
			window.prompt("Ctrl+C: ", copy);
		};
	</script>

Browser Support

ClipLab works with the latest version of JavaScript on Chrome, Firefox, Opera Mini and other browsers but as not being tested with IE (Internet Explorer).

About

A Simple JavaScript Library to copy text to clipboard.

Resources

License

Stars

Watchers

Forks

Packages

No packages published