svelte-copy
v2.0.0
Published
A svelte action to copy text to clipboard. It uses the `navigator.clipboard` api, with a fallback to the legacy method.
Downloads
15,299
Readme
Svelte Copy
A svelte action to copy text to clipboard. It uses the navigator.clipboard
api, with a fallback to the legacy method.
Installing
npm install svelte-copy -D
This library only works with Svelte 5, checkout svelte-copy@1 for Svelte 3/4 support.
Usage
The simplest use is to just pass the text you want to copy:
<script>
import { copy } from 'svelte-copy';
</script>
<button use:copy={'Hello World'}>
Click me!
</button>
You can expand that with an options object:
<script>
import { copy } from 'svelte-copy';
</script>
<button
use:copy={{
text,
events: ['click'],
onCopy({ text, event }) {
alert(`Text copied: "${text}". Triggered by "${event}"`);
},
onError({ error, event }) {
alert(error.message)
}
}}
>
Copy
</button>
Migrating from v1 to v2
- The
on:svelte-copy
event is now aonCopy
param to the action options. - The
on:svelte-copy:error
event is now aonError
param to the action options. - The
events
option now only acceptsstring[]
, rather thanstring | string[]
- Svelte 5 is now required