@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(...)
• read()
• Interfaces

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 |