Ioniconf 2022 logo

Uniting our global community of Ionic developers and contributors. May 25, 2022.

DocsPluginsCLI

@capacitor/clipboard

The Clipboard API enables copy and pasting to/from the system clipboard.

Install

npm install @capacitor/clipboard
npx cap sync

Example

import { Clipboard } from '@capacitor/clipboard';

const writeToClipboard = async () => {
  await Clipboard.write({
    string: "Hello World!"
  });
};

const checkClipboard = async () => {
  const { type, value } = await Clipboard.read();

  console.log(`Got ${type} from clipboard: ${value}`);
};

API

write(…)

write(options: WriteOptions) => Promise<void>

Write a value to the clipboard (the “copy” action)

Param Type
options WriteOptions

Since: 1.0.0


read()

read() => Promise<ReadResult>

Read a value from the clipboard (the “paste” action)

Returns: Promise<ReadResult>

Since: 1.0.0


Interfaces

WriteOptions

Represents the data to be written to the clipboard.

Prop Type Description Since
string string Text value to copy. 1.0.0
image string Image in Data URL format to copy. 1.0.0
url string URL string to copy. 1.0.0
label string User visible label to accompany the copied data (Android Only). 1.0.0

ReadResult

Represents the data read from the clipboard.

Prop Type Description Since
value string Data read from the clipboard. 1.0.0
type string Type of data in the clipboard. 1.0.0
Previous
<- Camera
Next
Device ->
Contribute ->