JarCasting
JarCasting JarCasting

copy-to-clipboard

WebJar for copy-to-clipboard

License

License

MIT
Categories

Categories

CLI User Interface
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

copy-to-clipboard
Last Version

Last Version

3.3.1
Release Date

Release Date
Type

Type

jar
Description

Description

copy-to-clipboard
WebJar for copy-to-clipboard
Project URL

Project URL

https://www.webjars.org
Source Code Management

Source Code Management

https://github.com/sudodoki/copy-to-clipboard

Download copy-to-clipboard

Filename Size
copy-to-clipboard-3.3.1.pom
copy-to-clipboard-3.3.1.jar 36 KB
copy-to-clipboard-3.3.1-sources.jar 22 bytes
copy-to-clipboard-3.3.1-javadoc.jar 22 bytes
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/copy-to-clipboard/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>copy-to-clipboard</artifactId>
    <version>3.3.1</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/copy-to-clipboard/
implementation 'org.webjars.npm:copy-to-clipboard:3.3.1'
// https://jarcasting.com/artifacts/org.webjars.npm/copy-to-clipboard/
implementation ("org.webjars.npm:copy-to-clipboard:3.3.1")
'org.webjars.npm:copy-to-clipboard:jar:3.3.1'
<dependency org="org.webjars.npm" name="copy-to-clipboard" rev="3.3.1">
  <artifact name="copy-to-clipboard" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='copy-to-clipboard', version='3.3.1')
)
libraryDependencies += "org.webjars.npm" % "copy-to-clipboard" % "3.3.1"
[org.webjars.npm/copy-to-clipboard "3.3.1"]

Dependencies

compile (1)

Group / Artifact Type Version
org.webjars.npm : toggle-selection jar [1.0.6,2)

Project Modules

There are no modules declared in this project.

Copy to clipboard Build Status

Simple module exposing copy function that will try to use execCommand with fallback to IE-specific clipboardData interface and finally, resort to usual prompt with proper text content and message.

Example

import copy from 'copy-to-clipboard';

copy('Text');

// Copy with options
copy('Text', {
  debug: true,
  message: 'Press #{key} to copy',
});

API

copy(text: string, options: object): boolean — tries to copy text to clipboard. Returns true if no additional keystrokes were required from user (so, execCommand, IE's clipboardData worked) or false.

Value Default Notes
options.debug false Boolean. Optional. Enable output to console.
options.message Copy to clipboard: #{key}, Enter String. Optional. Prompt message. *
options.format "text/html" String. Optional. Set the MIME type of what you want to copy as. Use text/html to copy as HTML, text/plain to avoid inherited styles showing when pasted into rich text editor.
options.onCopy null function onCopy(clipboardData: object): void. Optional. Receives the clipboardData element for adding custom behavior such as additional formats

* all occurrences of #{key} are replaced with ⌘+C for macOS/iOS users, and Ctrl+C otherwise.

Browser support

Works everywhere where prompt* is available. Works best (i.e. without additional keystrokes) in Chrome, FF, Safari 10+, and, supposedly, IE/Edge.

Note: does not work on some older iOS devices.
* – even though Safari 8 has prompt, you cannot specify prefilled content for prompt modal – thus it doesn't work as expected.

Installation

  • Can be used as npm package and then leveraged using commonjs bundler/loader:
npm i --save copy-to-clipboard
  • Can be utilized using wzrd.in. Add following script to your page:
<script src="https://wzrd.in/standalone/copy-to-clipboard@latest" async></script>

You will have window.copyToClipboard exposed for you to use.

UI components based on this package:

See also:

Running Tests

This project has some automated tests, that will run using nightwatch on top of selenium.

npm i
npm test

Typescript

This library has built-in Typescript definitions.

import * as copy from 'copy-to-clipboard';

Versions

Version
3.3.1
3.2.0
3.0.8
3.0.4