본문으로 건너뛰기

클립보드 (Clipboard)

시스템 클립보드에서 텍스트를 읽거나 쓰는 모듈입니다.

개요​

appify.clipboard는 기기 클립보드와 상호작용하는 기능을 제공합니다. 사용자가 텍스트를 복사하거나 현재 클립보드에 저장된 내용을 가져올 수 있습니다. 클립보드 읽기는 플랫폼 보안 정책에 따라 실패할 수 있으며, 이 경우 null을 반환합니다.

API​

getText(): Promise<string | null>​

클립보드에 저장된 텍스트를 읽어옵니다.

매개변수

없음

반환값: Promise<string | null> - 클립보드 텍스트. 읽기 실패 또는 내용이 없을 경우 null

예제

import { appify } from '@nolraunsoft/appify-sdk';

const text = await appify.clipboard.getText();
if (text !== null) {
  console.log('클립보드 내용:', text);
}

setText(text: string): Promise<boolean>​

클립보드에 텍스트를 복사합니다.

매개변수

이름타입필수설명
textstring예클립보드에 저장할 문자열

반환값: Promise<boolean> - 복사 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

const success = await appify.clipboard.setText('복사할 텍스트');
if (success) {
  alert('클립보드에 복사되었습니다.');
}

플랫폼별 참고사항​

  • iOS 16 이상에서는 클립보드 읽기 시 시스템 배너 알림이 표시될 수 있습니다.
  • Android에서는 앱이 포그라운드에 있을 때만 클립보드 읽기가 허용됩니다.

관련 문서​