1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
---
title: Clipboard API
slug: Web/API/Clipboard_API
tags:
- API
- Clipboard API
- Landing
- Overview
- 클립보드
translation_of: Web/API/Clipboard_API
---
<div>{{DefaultAPISidebar("Clipboard API")}}</div>
<p><strong>Clipboard API</strong>는 클립보드 명령(잘라내기, 복사, 붙여넣기)에 응답할 수 있는 기능 및 시스템 클립보드에 비동기적으로 읽고 쓸 수 있는 방법을 제공합니다. 클립보드 콘텐츠로의 접근은 <a href="/ko/docs/Web/API/Permissions_API">Permissions API</a>를 통해야 하며, 사용자 동의 없이는 콘텐츠를 읽거나 수정할 수 없습니다.</p>
<p>Clipboard API는 {{domxref("document.execCommand()")}}를 사용한 클립보드 접근을 대체하기 위해 디자인되었습니다.</p>
<h2 id="클립보드_접근">클립보드 접근</h2>
<p><code>Clipboard</code> 객체의 인스턴스를 생성하지 않고, 전역 {{domxref("Navigator.clipboard", "navigator.clipboard")}}를 사용해 시스템 클립보드에 접근합니다.</p>
<pre class="brush: js">navigator.clipboard.readText().then(
clipText => document.querySelector(".editor").innerText += clipText);</pre>
<p>위의 코드 조각은 클립보드에서 텍스트를 가져와서, <code>editor</code> 클래스를 가진 요소의 콘텐츠 뒤에 추가합니다. {{domxref("Clipboard.readText", "readText()")}}는 클립보드의 내용이 텍스트가 아니면 빈 문자열을 반환하므로, 이렇게 작성해도 안전합니다.</p>
<h2 id="인터페이스">인터페이스</h2>
<dl>
<dt>{{domxref("Clipboard")}} {{securecontext_inline}}</dt>
<dd>시스템 클립보드에서 텍스트와 데이터를 읽고 쓸 수 있는 인터페이스를 제공합니다. 명세는 'Async Clipboard API'라고 부릅니다.</dd>
<dt>{{domxref("ClipboardEvent")}} {{securecontext_inline}}</dt>
<dd>클립보드 수정에 관련된 정보를 제공하는 이벤트, 즉 {{domxref("Element/cut_event", "cut")}}, {{domxref("Element/copy_event", "copy")}}, {{domxref("Element/paste_event", "paste")}} 이벤트를 나타냅니다. 명세는 'Clipboard Event API'라고 부릅니다.</dd>
</dl>
<h2 id="명세">명세</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName('Clipboard API')}}</td>
<td>{{Spec2('Clipboard API')}}</td>
<td>Initial definition.</td>
</tr>
</tbody>
</table>
<h2 id="브라우저_호환성">브라우저 호환성</h2>
<h3 id="Clipboard"><code>Clipboard</code></h3>
<div>
<p>{{Compat("api.Clipboard")}}</p>
<h3 id="ClipboardEvent"><code>ClipboardEvent</code></h3>
<div class="hidden">The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</div>
<p>{{Compat("api.ClipboardEvent")}}</p>
<h2 id="같이_보기">같이 보기</h2>
<ul>
<li><a href="/ko/docs/Web/API/Permissions_API">Permissions API</a></li>
<li><a href="/ko/docs/Web/API/Permissions_API/Using_the_Permissions_API">Using the Permissions API</a></li>
</ul>
</div>
|
