An open API service indexing awesome lists of open source software.

https://github.com/compactjs/clipboard

Copy to clipboard.
https://github.com/compactjs/clipboard

clipboard copy javascript

Last synced: 3 months ago
JSON representation

Copy to clipboard.

Awesome Lists containing this project

README

        

@compactjs/clipboard


Copy to clipboard.




Version


License: MIT



·
Homepage
·
View Demo
·
Report Bug / Request Feature
·

## Table of Contents

- [Installation](#Install)
- [Usage](#usage)
- [Test](#run-tests)
- [Contact](#contact)
- [Contributing](#Contributing)
- [License](#license)

## Install

### NPM:

```sh
npm install @compactjs/clipboard
```

### CDN:

```html

```

## Usage

### As module:

```javascript
import { clipboard } from '@compactjs/clipboard';
```

API:

```typescript
/**
* Copy text to clipboard.
* @param input Either text to copy or HTMLElement to copy from
*/
function clipboard(
input: string | HTMLTextAreaElement | HTMLInputElement
): void;
```

**Note:** A copy to clipboard need to be triggered by user action, like a button press!

### Example:

```javascript
document
.getElementById('copy-string')
.addEventListener('click', () =>
clipboard('This text is going to be copied.')
);
```

Have a look at the [example](https://github.com/CompactJS/clipboard/blob/main/example/index.html).

Or checkout the [demo](https://compactjs.github.io/clipboard).

## Run tests

```sh
npm run test
```

## Contact

👤 **Timo Bechtel**

- Website: https://timobechtel.com
- Twitter: [@TimoBechtel](https://twitter.com/TimoBechtel)
- GitHub: [@TimoBechtel](https://github.com/TimoBechtel)

## 🤝 Contributing

Contributions, issues and feature requests are welcome!

1. Check [issues](https://github.com/CompactJS/clipboard/issues)
1. Fork the Project
1. Create your Feature Branch (`git checkout -b feat/AmazingFeature`)
1. Test your changes `npm run test`
1. Commit your Changes (`git commit -m 'feat: add amazingFeature'`)
1. Push to the Branch (`git push origin feat/AmazingFeature`)
1. Open a Pull Request

### Commit messages

This project uses semantic-release for automated release versions. So commits in this project follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0-beta.2/) guidelines. I recommend using [commitizen](https://github.com/commitizen/cz-cli) for automated commit messages.

## Show your support

Give a ⭐️ if this project helped you!

## 📝 License

Distributed under the [MIT](https://github.com/CompactJS/clipboard/blob/main/LICENSE) License.

---

_This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_