Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ko] api/Navigator/clipboard 신규 번역 #23599

Merged
merged 11 commits into from
Oct 27, 2024
41 changes: 41 additions & 0 deletions files/ko/web/api/navigator/clipboard/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: "Navigator: clipboard 속성"
slug: Web/API/Navigator/clipboard
l10n:
sourceCommit: d47348199a379f68bea876a403eb510628ec4ccb
---

{{APIRef("Clipboard API")}} {{securecontext_header}}
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

**`clipboard`** 는 {{domxref("Navigator")}} 인터페이스의 읽기 전용 속성이며, 클립보드의 내용을 읽기 혹은 쓰기 용도로서 객체로 반환합니다.
[Clipboard API](/ko/docs/Web/API/Clipboard_API)는 웹 애플리케이션에서 잘라내기, 복사 혹은 붙여넣기 기능을 사용할 수 있도록 하는 기능입니다.

## 값

{{domxref("Clipboard")}} 는 시스템 클립보드에 접근하는 객체입니다.

## 예제

아래의 코드는 시스템 클립보드 내부 텍스트를 읽기 위해 접근하는 속성인 `navigator.clipboard`를 사용하는 예제입니다.

```js
navigator.clipboard
.readText()
.then(
(clipText) => (document.querySelector(".clip-text").innerText = clipText),
);
```

위의 예제는 `"clip-text"` 클래스를 가지고 있는 요소의 내용을 클립보드 내용으로 변경하는 코드입니다.
이 코드는 클립보드의 내용을 불러오는 브라우저 익스텐션으로서 클립보드 내용이 주기적으로 혹은 자동으로 갱신되거나 특정 이벤트가 실행될 때 자동으로 갱신됩니다.

클립보드에 텍스트가 없거나 비어있다면 `"clip-text"` 클래스 요소의 내용은 초기화됩니다.
이러한 경우에는 [`readText()`](/ko/docs/Web/API/Clipboard/readText) 가 비어있는 스트링 값을 반환합니다.

## 명세서

{{Specifications}}

## 브라우저 호환성

{{Compat}}