clipboard
시스템 클립보드를 읽고 쓰는 네임스페이스입니다. 초대 코드 공유, 쿠폰 붙여넣기, "링크 복사" 버튼 같은 흔한 모바일 UX에 쓰입니다.
비공식 문서
이 페이지는 커뮤니티가 작성한 설명입니다. SDK의 동작은 상위의 @apps-in-toss/web-framework 배포본을 기준으로 합니다.
메서드
| 메서드 | 용도 |
|---|---|
getClipboardText | 클립보드에서 텍스트를 읽어 옵니다. |
setClipboardText | 클립보드에 텍스트를 복사합니다. |
권한
네임스페이스 전체가 단일 clipboard 권한을 공유합니다. 두 메서드 모두 같은 PermissionName에 바인딩되어 있습니다. 한쪽에서 승인받으면 다른 쪽도 즉시 사용 가능하고, setClipboardText.getPermission()과 getClipboardText.getPermission()은 언제나 같은 값을 돌려줍니다 — 상태 확인은 둘 중 편한 쪽으로 하면 됩니다.
denied상태에서 호출하면 에러가 throw 됩니다. 호출 전getPermission()으로 상태를 확인하세요.- 권한이 아직 없으면
openPermissionDialog()로 시스템 다이얼로그를 띄울 수 있습니다.
두 메서드 모두 getPermission() / openPermissionDialog() 유틸이 함수 객체에 붙어 있습니다 — 각 페이지의 "권한" 섹션을 참고하세요.
UX 가이드
- **쓰기(write)**는 사용자가 "복사" 같은 명시적 액션을 눌렀을 때 수행하고, 성공 시 토스트로 피드백을 주세요.
- **읽기(read)**는 자동 읽기 대신 "붙여넣기" 버튼에서만 호출하길 권장합니다. 백그라운드에서의 클립보드 접근은 사용자 입장에서 예상 밖의 동작이고, OS가 차후 차단할 가능성도 있습니다.
- 읽어 온 문자열은 항상 검증하세요. 사용자가 의도하지 않은 텍스트가 들어 있을 수 있습니다 (초대 코드 형식 검사, URL 도메인 화이트리스트 등).
직접 실행해 보기
sdk-example의 Clipboard 페이지에서 두 메서드를 모두 실험해 볼 수 있습니다.
sdk-example에서 실행해 보기외부 참조
@apps-in-toss/web-framework— 상위 SDK 패키지. 실제 export는 내부적으로@apps-in-toss/web-bridge에서 가져옵니다.