본문으로 건너뛰기

클립보드 (clipboard)

🚀 추가된 버전 : SDKSDKv1.4.0 AndroidAndroidv1.4.0 iOSiOSv1.4.0
🔔 최신화 일자: 2025-07-22

개요

clipboard 네임스페이스는 디바이스의 네이티브 클립보드에 텍스트를 복사하거나, 현재 저장된 텍스트를 가져오는 기능을 제공합니다.

이 기능을 사용하여 사용자 인터페이스와 클립보드 간에 데이터를 효율적으로 공유할 수 있습니다.

주의

일부 디바이스 또는 특정 OS 버전에서는 클립보드 접근이 제한될 수 있습니다.

클립보드 기능은 SDK ver.1.6.3부터 웹, Android, iOS 플랫폼 모두에서 사용 가능합니다.


메서드 목록

메서드설명추가된 버전수정된 버전
getText(callback)네이티브 클립보드에 저장된 텍스트를 반환합니다.SDKSDKv1.4.0SDKSDKv1.6.3
setText(text, callback?)텍스트를 네이티브 클립보드에 저장합니다.SDKSDKv1.4.0SDKSDKv1.6.3

메서드 상세

getText(callback: (text: string) => void): void

설명

디바이스의 네이티브 클립보드에 저장된 텍스트를 가져옵니다.
해당 메서드는 콜백 함수로 복사한 텍스트 값을 전달합니다.

getText 메서드는 SDK ver.1.6.3부터 웹, Android, iOS 플랫폼 모두에서 사용 가능합니다.

지원 플랫폼

getText 메서드는 App과 Web 모든 환경을 지원합니다.

플랫폼지원 여부비고
Android네이티브 Clipboard 사용
iOS네이티브 Clipboard 사용
WebWeb Clipboard API 사용

매개변수

이름타입필수 여부설명
callback(text: string) => void클립보드에 저장된 텍스트 반환 함수

반환 값

해당 메서드는 반환 값을 가지지 않으며, 텍스트는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

// 네이티브 클립보드에서 텍스트를 가져옵니다.
Nachocode.clipboard.getText(text => {
console.log('클립보드 내용:', text);
alert(`클립보드에서 가져온 텍스트: ${text}`);
});

setText(text: string, callback?: (status: 'success' | 'error', message: string) => void): void

설명

입력된 텍스트를 네이티브 클립보드에 저장합니다.
선택적으로 콜백 함수를 통해 복사 성공 여부와 메시지를 전달받을 수 있습니다.

setText 메서드는 SDK ver.1.6.3부터 웹, Android, iOS 플랫폼 모두에서 사용 가능합니다.

지원 플랫폼

setText 메서드는 App과 Web 모든 환경을 지원합니다.

플랫폼지원 여부비고
Android네이티브 Clipboard 사용
iOS네이티브 Clipboard 사용
WebWeb Clipboard API 사용

매개변수

이름타입필수 여부설명
textstring클립보드에 저장할 텍스트
callback(status: 'success' | 'error', message: string) => void복사 결과 및 메시지를 반환하는 함수
  • status: 복사 성공 여부 (success 또는 error)
  • message: 복사 성공 또는 오류 메시지

반환 값

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

// 네이티브 클립보드에 텍스트를 저장합니다.
Nachocode.clipboard.setText('Hello nachocode!', (status, message) => {
if (status === 'success') {
console.log('클립보드에 텍스트가 성공적으로 복사되었습니다.');
} else {
console.error('클립보드에 복사 실패:', message);
}
});