expo-clipboard
provides an interface for getting and setting Clipboard content on Android, iOS, and Web.Android Device | Android Emulator | iOS Device | iOS Simulator | Web |
---|---|---|---|---|
→
expo install expo-clipboard
If you're installing this in a bare React Native app, you should also follow these additional installation instructions.
import * as React from 'react'; import { View, Text, Button, StyleSheet } from 'react-native'; import * as Clipboard from 'expo-clipboard'; export default function App() { const [copiedText, setCopiedText] = React.useState(''); const copyToClipboard = () => { Clipboard.setString('hello world'); }; const fetchCopiedText = async () => { const text = await Clipboard.getStringAsync(); setCopiedText(text); }; return ( <View style={styles.container}> <Button title="Click here to copy to Clipboard" onPress={copyToClipboard} /> <Button title="View copied text" onPress={fetchCopiedText} /> <Text style={styles.copiedText}>{copiedText}</Text> </View> ); } %%placeholder-start%%const styles = StyleSheet.create({ ... }); %%placeholder-end%%const styles = StyleSheet.create({ container: { flex: 1, justifyContent: 'center', alignItems: 'center', }, copiedText: { marginTop: 10, color: 'red', }, });
import * as Clipboard from 'expo-clipboard';
string
)(event: T) => void
)Gets the content of the user's clipboard. Please note that calling this method on web will prompt the user to grant your app permission to "see text and images copied to the clipboard."
string
) - The string to save to the clipboard.Sets the content of the user's clipboard.
void
On web, this returns a boolean value indicating whether or not the string was saved to the user's clipboard. On iOS and Android, nothing is returned.
(event: ClipboardEvent) => void
) - Callback to execute when listener is triggered. The callback is provided a
single argument that is an object with a content
key.Adds a listener that will fire whenever the content of the user's clipboard changes. This method is a no-op on Web.
addClipboardListener(({ content }: ClipboardEvent) => { alert('Copy pasta! Here's the string that was copied: ' + content); });
Subscription
) - The subscription to remove (created by addClipboardListener).Removes the listener added by addClipboardListener. This method is a no-op on Web.
const subscription = addClipboardListener(() => { alert('Copy pasta!'); }); removeClipboardListener(subscription);
void
Name | Type | Description |
---|---|---|
content | string | The new content of the user's clipboard. |
Name | Type | Description |
---|---|---|
remove | () => void | A method to unsubscribe the listener. |