본문으로 건너뛰기

클립보드 (clipboard)

🔔 최신화 일자: 2025-02-20

개요​

clipboard 네임스페이스는 디바이스의 네이티브 클립보드에 텍스트를 복사하거나, 현재 저장된 텍스트를 가져오는 기능을 제공합니다.
이 기능을 사용하여 사용자 인터페이스와 클립보드 간에 데이터를 효율적으로 공유할 수 있습니다.

메서드 목록​

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

메서드 상세​

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

  • since ver.1.4.0

설명 (getText)​

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

매개변수 (getText)​

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

반환 값 (getText)​

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

사용 예제 (getText)​

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

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

  • since ver.1.4.0

설명 (setText)​

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

매개변수 (setText)​

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

반환 값 (setText)​

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

사용 예제 (setText)​

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

추가 정보​

  • getText 메서드는 사용자가 직접 클립보드에 복사한 텍스트 값을 반환합니다.
  • setText 메서드는 앱 내에서 복사한 텍스트 값을 네이티브 클립보드에 저장할 수 있습니다.
  • 일부 디바이스 또는 특정 OS 버전에서는 클립보드 접근이 제한될 수 있습니다.