클립보드 API 및 이벤트

5.2.1.1. clipboardchange 이벤트 발생 단계

Document document에 대해 clipboardchange 이벤트를 발생시키려면:

1. document가 고정 활성화를 갖지 않고 document가 클립보드에서 읽을 권한도 갖지 않으면, 반환한다.

2. global을 document의 관련 전역 객체로 둔다.

3. document가 시스템 포커스를 가지면:

   1. types를 필수 데이터 타입 중 시스템 클립보드에서 사용할 수 있는 것들의 목록으로 둔다.

   2. changeId를 document가 주어졌을 때 changeId 생성을 실행한 결과로 둔다.

   3. eventInit을 새 ClipboardChangeEventInit 딕셔너리로 두며, 그 types 멤버는 types로, 그 changeId 멤버는 changeId로 설정한다.

   4. eventInit을 사용하여, ClipboardChangeEvent를 사용해 global에서 clipboardchange라는 이름의 이벤트를 발화한다.

4. document가 시스템 포커스를 갖지 않으면:

   1. document의 clipboardchange 보류 플래그를 true로 설정한다.

5.2.1.2. 문서 포커스 단계

Document document가 시스템 포커스를 얻을 때:

1. document의 clipboardchange 보류 플래그가 true이면:

   1. document의 clipboardchange 보류 플래그를 false로 설정한다.

   2. types를 필수 데이터 타입 중 시스템 클립보드에서 사용할 수 있는 것들의 목록으로 둔다.

   3. changeId를 document가 주어졌을 때 changeId 생성을 실행한 결과로 둔다.

   4. eventInit을 새 ClipboardChangeEventInit 딕셔너리로 두며, 그 types 멤버는 types로, 그 changeId 멤버는 changeId로 설정한다.

   5. global을 document의 관련 전역 객체로 둔다.

   6. eventInit을 사용하여, ClipboardChangeEvent를 사용해 global에서 clipboardchange라는 이름의 이벤트를 발화한다.

5.2.1.3. ClipboardChangeEvent 생성자 단계

ClipboardChangeEvent(type, eventInitDict) 생성자 단계는 다음과 같습니다:

1. this.types 를 eventInitDict["types"]의 복제본(clone)으로 설정합니다.

2. this.changeId 를 eventInitDict["changeId"]로 설정합니다.

Document document에 대해 changeId를 생성하려면:

1. globalChangeId를 시스템 클립보드의 현재 상태를 나타내는 사용자 에이전트별 고유 식별자로 둔다. 이 식별자는 시스템 클립보드가 수정될 때마다 변경되며, 사용자 에이전트가 다시 시작될 때 재설정된다.

2. storageKey를 document의 관련 설정 객체가 주어졌을 때 비저장소 목적을 위한 저장소 키 얻기를 실행한 결과로 둔다.

3. storageKeyBytes를 storageKey의 사용자 에이전트별 이진 표현으로 둔다.

4. hashedValue를 globalChangeId(바이트로서)와 storageKeyBytes의 연결에 암호학적 해시 함수(예: SHA-256)를 적용한 결과로 둔다.

5. hashedValue에서 도출된 128비트 정수(예를 들어 해시 출력의 처음 128비트를 취함)를 반환한다.

스크립트-클립보드-접근-허용 플래그는 다음과 같이 설정됩니다:

1. 동작이 복사 또는 잘라내기이고, 스크립트 스레드가 클립보드 수정 허용이면,

   1. 동작의 스크립트-클립보드-접근-허용 플래그를 설정한다

2. 동작이 붙여넣기이고, 스크립트 스레드가 클립보드 읽기 허용이면,

   1. 동작의 스크립트-클립보드-접근-허용 플래그를 설정한다.

복사 동작은 다음 단계로 구성됩니다:

1. script-triggered 플래그가 설정되어 있으면,

   1. script-may-access-clipboard 플래그가 설정되어 있지 않으면,

      1. 복사 작업에서 false를 반환하고, 이 알고리즘을 종료합니다.

2. "copy"라는 이름의 copy 클립보드 이벤트를 발생시킵니다.

3. 이벤트가 취소되지 않았다면,

   1. 선택한 내용(있는 경우)을 클립보드에 복사합니다. 구현체는 웹 페이지에서 내용이 선택되었을 때 대체 text/html 및 text/plain 클립보드 포맷을 생성하는 것이 권장됩니다.

   2. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

4. 그렇지 않고 이벤트가 취소되었다면,

   1. 클립보드에 내용 쓰기 알고리즘을 호출합니다. 이때 DataTransferItemList 리스트 items와 clear-was-called 플래그, types-to-clear 리스트를 전달합니다.

5. 복사 작업에서 true를 반환합니다.

잘라내기 동작은 다음 단계로 구성됩니다:

1. script-triggered 플래그가 설정되어 있다면,

   1. script-may-access-clipboard 플래그가 설정 해제되어 있다면,

      1. 잘라내기 작업에서 false를 반환하고, 이 알고리즘을 종료합니다.

2. "cut"라는 이름의 cut 클립보드 이벤트를 발생시킵니다.

3. 이 이벤트가 취소되지 않았다면,

   1. 선택 영역이 편집 가능한 컨텍스트 내에서 잘라내기가 활성화된 상태라면,

      1. 선택된 내용(있는 경우)을 클립보드에 복사합니다. 구현체는 웹 페이지에서 내용이 선택되었을 때 대체 text/html 및 text/plain 클립보드 포맷을 생성하는 것이 권장됩니다.

      2. 문서에서 해당 선택 영역의 내용을 제거하고 선택 영역을 축소합니다.

      3. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

      4. 변경으로 인해 발생해야 하는 모든 이벤트를 큐에 넣어 발생시키십시오. 자세한 내용은 § 5.3 다른 스크립트 및 이벤트와의 통합을 참조하세요.

   2. 그렇지 않고 선택 영역이 없거나, 컨텍스트가 편집 가능하지 않으면,

      1. false를 반환합니다.

4. 그 외에, 만약 이벤트가 취소되었다면,

   1. 클립보드에 내용 쓰기 알고리즘을 호출합니다. 이때 DataTransferItemList 리스트 items와, clear-was-called 플래그, types-to-clear 리스트를 넘깁니다.

   2. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

5. 잘라내기 작업에서 true를 반환합니다.

붙여넣기 동작은 다음 단계로 구성됩니다:

1. 스크립트-트리거됨 플래그가 설정되어 있으면,

   1. 스크립트-클립보드-접근-허용 플래그가 설정되어 있지 않으면,

      1. 붙여넣기 동작에서 false를 반환하고, 알고리즘을 종료한다

2. paste라는 이름의 클립보드 이벤트를 발생시킨다

3. 이 이벤트가 취소되지 않았으면,

   1. editable context에서 붙여넣기가 허용된 선택 영역이나 커서가 존재하면,

      1. 클립보드에서 찾은 가장 적합한 콘텐츠(있는 경우)를 해당 컨텍스트에 삽입한다.

      2. 수정으로 인해 발생해야 하는 이벤트들을 큐에 추가한다. 자세한 내용은 § 5.3 다른 스크립트 및 이벤트와의 통합을 참고한다.

   2. 그렇지 않으면

      1. false를 반환한다

4. 그렇지 않고 이벤트가 취소되었다면

   1. false를 반환한다

5. 동작에서 true를 반환한다

9.1.1. 클립보드 읽기 권한 확인

1. hasGesture를 relevant global object가 this에서 일시적 활성화(transient activation)를 가지고 있으면 true, 그렇지 않으면 false로 한다.

2. hasGesture이면,

   1. 현재 스크립트가 사용자 에이전트나 OS가 생성한 "Paste" 요소와의 사용자 상호작용 결과로 실행되고 있다면 true를 반환한다.

3. false를 반환한다.

9.2.1. 클립보드 쓰기 권한 확인

1. writeWithoutGesture를 permission state({ name: "clipboard-write", allowWithoutGesture: true } 권한 기준)로 한다.

2. writeWithoutGesture가 granted이면 true를 반환한다.

3. hasGesture를 this의 관련 글로벌 객체에 일시적 활성화(transient activation)가 있으면 true로, 그렇지 않으면 false로 둡니다.

4. hasGesture이면,

   1. 현재 스크립트가 사용자 에이전트나 OS가 생성한 "cut" 또는 "copy" 요소와의 사용자 상호작용 결과로 실행되고 있다면 systemCopy를 true로 한다.

   2. systemCopy가 true이면 true를 반환한다.

   3. request permission to use({ name: "clipboard-write", allowWithoutGesture: false } 권한 기준) 결과를 반환한다.

      참고: 사용자 에이전트는 더 강력한 권한을 요청하여 이 권한을 암묵적으로 업데이트할 수도 있습니다.

5. request permission to use({ name: "clipboard-write", allowWithoutGesture: true } 권한 기준) 결과를 반환한다.

클립보드에 콘텐츠 쓰기

입력

items : DataTransferItemList 클립보드에 쓸 아이템 리스트

clear-was-called : boolean 값

types-to-clear : 리스트

출력

없음

1. items 리스트가 비어 있지 않으면,

   1. 클립보드를 비운다

   2. 리스트의 각 파트에 대해,

      1. 데이터 타입이 text/plain이면,

         1. OS 및 로캘 관례에 따라 인코딩이 올바른지 확인

         2. 플랫폼 관례에 따라 줄바꿈을 정규화

         3. OS 클립보드 포맷 설명에 맞게 텍스트를 클립보드에 넣는다

      2. 그 외, 데이터가 필수 데이터 타입 리스트에 포함된 타입이면,

         1. OS 클립보드 포맷 설명에 맞게 파트를 클립보드에 넣는다

      3. 그 외의 경우

         1. 이는 구현체에 맡긴다...

            구현체에 맡기는 것은 바람직하지 않음. 여기서 무엇을 해야 할까?

            참고: OS 클립보드 구현의 한계로 인해, 스크립트는 커스텀 포맷이 시스템의 다른 애플리케이션에서도 사용 가능할 것이라 가정해서는 안 됩니다. 예를 들어, Microsoft Windows에서는 등록할 수 있는 커스텀 클립보드 포맷 수에 제한이 있습니다. setData()의 type 인자로 아무 문자열이나 사용할 수 있지만, 필수 데이터 타입을 사용하는 것이 강력히 권장됩니다.

2. 그 외, items 리스트가 비어 있다면, 아래와 같이 클립보드를 비울지 결정한다:

   1. 아이템 리스트가 비어 있고 clear-was-called 플래그가 true이면,

      1. types-to-clear 리스트가 비어 있으면,

         1. 클립보드를 비운다

      2. 그 외의 경우

         1. OS 및 구현체별 방식으로 types-to-clear 리스트의 타입들을 클립보드에서 제거한다

            "클립보드에서 특정 타입 제거" 기능은 위험에 처해있음. 꼭 필요하지 않고, 모든 플랫폼에서 쉽게 구현할 수 있는지 불명확함.

블롭과 옵션을 클립보드에 기록하기

입력

items, sequence<Blob>

presentationStyle, 클립보드 항목의 표현 스타일

출력

없음

1. webCustomFormats를 sequence<Blob>로 둔다.

2. items 안의 각 item에 대해:

   1. formatString을 item의 type이 주어졌을 때 OS별 잘 알려진 형식을 실행한 결과로 둔다.

   2. formatString이 비어 있으면 아래 단계를 따른다:

      1. webCustomFormatString을 item의 type으로 둔다.

      2. webCustomFormat을 빈 type으로 둔다.

      3. webCustomFormatString이 `"web "` 접두사로 시작하면, `"web "` 접두사를 제거하고 남은 문자열을 webMimeTypeString에 저장한다.

      4. webMimeType을 webMimeTypeString이 주어졌을 때 MIME 타입 파싱의 결과로 둔다.

      5. webMimeType이 failure이면, 모든 단계를 중단한다.

      6. webCustomFormat의 type의 essence가 webMimeType과 같게 둔다.

      7. item의 type을 webCustomFormat으로 설정한다.

      8. webCustomFormat을 webCustomFormats에 추가한다.

   3. payload를 item의 기반 바이트 시퀀스에 대한 UTF-8 디코딩 결과로 둔다.

   4. formatString을 네이티브 클립보드 형식으로 사용하여 payload와 presentationStyle을 시스템 클립보드에 삽입한다.

   일부 OS는 여러 클립보드를 포함한다(예: Linux, "primary", "secondary", "selection"). 이들 중 어느 곳에 데이터가 쓰이는지 정의하라.

3. webCustomFormats가 주어졌을 때 웹 사용자 정의 형식 쓰기를 실행한다.

OS별 알려진 포맷

입력

mimeType, type

출력

wellKnownFormat, 플랫폼별 문자열 타입. Mac에서는 NSPasteboardType이고, Windows에서는 LPCWSTR이며 Linux에서는 const char*이다.

Windows의 경우 https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 및 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN 참조. Mac의 경우 https://developer.apple.com/documentation/appkit/nspasteboardtype 참조.

1. wellKnownFormat을 빈 문자열로 둔다.

2. mimeType의 essence가 "text/plain"이면,

   Windows에서는 아래에 설명된 규칙을 따른다:

   1. CF_UNICODETEXT를 wellKnownFormat에 할당한다.

   MacOS에서는 아래에 설명된 규칙을 따른다:

   1. NSPasteboardTypeString을 wellKnownFormat에 할당한다.

   Linux, ChromeOS 및 Android에서는 아래에 설명된 규칙을 따른다:

   1. "text/plain"을 wellKnownFormat에 할당한다.

3. 그렇지 않고, mimeType의 essence가 "text/html"이면,

   Windows에서는 아래에 설명된 규칙을 따른다:

   1. CF_HTML을 wellKnownFormat에 할당한다.

   MacOS에서는 아래에 설명된 규칙을 따른다:

   1. NSPasteboardTypeHTML을 wellKnownFormat에 할당한다.

   Linux, ChromeOS 및 Android에서는 아래에 설명된 규칙을 따른다:

   1. "text/html"을 wellKnownFormat에 할당한다.

4. 그렇지 않고, mimeType의 essence가 "image/png"이면,

   Windows에서는 아래에 설명된 규칙을 따른다:

   1. "PNG"를 wellKnownFormat에 할당한다.

   MacOS에서는 아래에 설명된 규칙을 따른다:

   1. NSPasteboardTypePNG를 wellKnownFormat에 할당한다.

   Linux, ChromeOS 및 Android에서는 아래에 설명된 규칙을 따른다:

   1. "image/png"를 wellKnownFormat에 할당한다.

5. 그렇지 않고, mimeType의 essence가 "image/svg+xml"이면,

   Windows에서는 아래에 설명된 규칙을 따른다:

   1. CFSTR_MIME_SVG_XML을 wellKnownFormat에 할당한다.

   MacOS에서는 아래에 설명된 규칙을 따른다:

   1. UTTypeSVG를 wellKnownFormat에 할당한다.

   Linux, ChromeOS 및 Android에서는 아래에 설명된 규칙을 따른다:

   1. "image/svg+xml"을 wellKnownFormat에 할당한다.

6. wellKnownFormat을 반환한다.

OS별 포맷에서 알려진 MIME 타입

입력

osFormatName : 플랫폼별 문자열 타입 (Mac: NSPasteboardType, Windows: LPCWSTR, Linux: const char*)

출력

mimeType : MIME type

Windows: https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 및 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Mac: https://developer.apple.com/documentation/appkit/nspasteboardtype

Windows에서는 다음과 같이:

1. osFormatName이 "UnicodeText"면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 "HTML Format"이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 "PNG"이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 CFSTR_MIME_SVG_XML이면 mimeTypeString을 "image/svg+xml"로 설정

MacOS에서는 다음과 같이:

1. osFormatName이 NSPasteboardTypeString이면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 NSPasteboardTypeHTML이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 NSPasteboardTypePNG이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 UTTypeSVG이면 mimeTypeString을 "image/svg+xml"로 설정

Linux, ChromeOS, Android에서는 다음과 같이:

1. osFormatName이 "text/plain"이면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 "text/html"이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 "image/png"이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 "image/svg+xml"이면 mimeTypeString을 "image/svg+xml"로 설정

1. mimeType을 MIME 타입 파싱(mimeTypeString 기준) 결과로 한다.

2. mimeType을 반환한다.

웹 커스텀 포맷 읽기

입력

item, 클립보드 항목

1. webCustomFormatMap을 OS별 사용자 정의 맵 이름으로 둔다.

2. 시스템 클립보드에서 webCustomFormatMap을 읽는다.

   webCustomFormatMap을 읽는 과정을 더 자세히 명시하라.

3. webCustomFormatMap이 비어 있으면, item을 반환한다.

4. webCustomFormatMapString을 webCustomFormatMap에서 역직렬화된 JSON 문자열로 둔다.

   Note: webCustomFormatMap에서 콘텐츠를 역직렬화하려면 JSON 리더가 필요하다.

5. webCustomFormatMapString 안의 각 (key, value)에 대해:

   1. mimeType을 key가 주어졌을 때 MIME 타입 파싱의 결과로 둔다.

   2. mimeType이 failure이면, 루프를 계속한다.

   3. representation을 새 표현으로 둔다.

   4. representation의 MIME 타입을 mimeType으로 설정한다.

   5. representation의 isCustom 플래그를 true로 설정한다.

   6. representation의 데이터를 새 promise로 설정한다.

      Note: 이 웹 사용자 정의 형식에 대한 OS 클립보드 데이터는 작성자가 결과 getType()을 ClipboardItem 객체에서 호출할 때까지 가져오지 않는다.

   7. representation을 item의 표현 목록에 추가한다.

웹 커스텀 포맷 쓰기

입력

items, sequence<Blob>

1. idx를 0으로 초기화된 숫자로 둔다.

2. webCustomFormatMap을 OS별 사용자 정의 맵 이름으로 둔다.

3. webCustomFormatMapString을 빈 JSON 문자열로 둔다.

4. items 안의 각 item에 대해:

   1. webCustomFormat을 OS별 사용자 정의 이름으로 둔다.

   2. webCustomFormatIdx를 idx를 webCustomFormat에 추가한 결과로 둔다.

   3. item의 type을 키로, webCustomFormatIdx를 값으로 하여 JSON serializer를 사용해 webCustomFormatMapString에 삽입한다.

      Note: 콘텐츠를 webCustomFormatMapString으로 직렬화하려면 JSON writer가 필요하다.

   4. webCustomFormatIdx를 형식으로 사용하여 item을 시스템 클립보드에 삽입한다.

   5. idx를 증가시킨다.

   6. idx가 100보다 크면, 이 루프에서 빠져나온다.

5. webCustomFormatMap을 형식으로 사용하여 webCustomFormatMapString을 시스템 클립보드에 삽입한다.

OS별 커스텀 포맷 맵 이름

출력

webCustomFormatMap, 문자열

Windows에서는 다음과 같이:

1. webCustomFormatMap에 "Web Custom Format Map" 할당.

2. webCustomFormatMap 반환.

MacOS에서는 다음과 같이:

1. webCustomFormatMap에 "org.w3.web-custom-format.map" 할당.

2. webCustomFormatMap 반환.

Linux, ChromeOS, Android에서는 다음과 같이:

1. webCustomFormatMap에 "application/web;type=\"custom/formatmap\"" 할당.

2. webCustomFormatMap 반환.

운영체제별 커스텀 이름

출력

webCustomFormat, 문자열

Windows에서는 다음 기준을 따른다:

1. webCustomFormat에 "Web Custom Format"을 할당한다.

2. webCustomFormat을 반환한다.

MacOS에서는 다음 기준을 따른다:

1. webCustomFormat에 "org.w3.web-custom-format.type-"을 할당한다.

2. webCustomFormat을 반환한다.

Linux, ChromeOS, Android에서는 다음 기준을 따른다:

1. webCustomFormat에 "application/web;type="custom/format"을 할당한다.

2. webCustomFormat을 반환한다.

클립보드 이벤트 발생시키기

입력

e, ClipboardEvent 발생시킬 이벤트

출력

없음

1. clear-was-called을 false로 한다.

2. types-to-clear를 빈 리스트로 한다.

3. clipboard-event-data를 새로운 DataTransfer 객체로, items 리스트는 빈 값으로 생성한다.

4. clipboard-entry를 현재 클립보드 콘텐츠의 시퀀스 번호로 하거나, OS 클립보드가 시퀀스 번호를 지원하지 않는 경우 null로 한다.

5. trusted를 이벤트가 사용자 에이전트에 의해 생성된 경우 true, 그렇지 않으면 false로 한다.

6. target을 다음과 같이 설정한다:

   1. 컨텍스트가 편집 가능하면,

      1. target을 선택 영역이나 커서가 있는 요소(문서 순서상)로 하거나, 선택 영역/커서가 없으면 body 요소로 한다.

   2. 그 외 컨텍스트가 편집 불가능하면,

      1. target을 포커스된 노드로 하거나, 포커스된 노드가 없으면 body 요소로 한다.

7. 이벤트를 다음과 같이 처리한다:

   1. e가 "paste"이면,

      1. clipboard-event-data의 내부 drag data store mode 플래그를 read-only로 설정한다.

      2. trusted가 true이거나, 구현체가 스크립트 생성 이벤트에 OS 클립보드 읽기 권한을 부여하도록 설정된 경우,

         1. OS 클립보드의 각 clipboard-part에 대해 아래를 수행한다:

            1. clipboard-part가 평문 텍스트를 포함하면,

               1. 텍스트가 스크립트 엔진 내부 인코딩에 맞는지 확인한다.

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 string, drag data item type string은 text/plain으로 한다.

               3. new-data의 데이터를 평문 텍스트로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

            2. clipboard-part가 파일 참조를 나타내면, 각 파일 참조에 대해:

               1. 참조된 파일의 MIME 타입을 결정한다.

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 file, drag data item type string은 해당 MIME 타입(모르면 application/octet-stream)으로 한다.

               3. new-data의 데이터를 파일 참조 데이터로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

            3. clipboard-part가 HTML 또는 XHTML 형식의 텍스트를 포함하면(OS 클립보드 포맷 설명 기준),

               1. 구현체가 HTML 붙여넣기를 지원하면, HTML 붙여넣기 이벤트 처리(clipboard-part, clipboard-event-data)를 호출한다.

            4. clipboard-part가 다른 지원되는 바이너리 혹은 텍스트 기반 포맷(see 필수 데이터 타입)의 데이터를 포함하면,

               1. 데이터의 MIME 타입 결정

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 file, drag data item type string은 해당 MIME 타입으로 한다.

               3. new-data의 데이터를 바이너리 또는 텍스트 기반 데이터로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

      3. clipboard-event-data의 files 속성을 clipboard-event-data의 items 항목에 맞게 갱신한다.

      4. clipboard-event-data의 types 속성을 clipboard-event-data의 items 항목에 맞게 갱신한다.

   2. e가 "copy" 또는 "cut"이면,

      1. 해당 DataTransfer 객체의 내부 drag data store mode 플래그를 read/write로 한다.

8. e의 clipboardData 를 clipboard-event-data로 설정한다.

9. e의 isTrusted 를 trusted로 설정한다.

10. e의 composed 를 true로 설정한다.

11. 이벤트 e를 target에 버블링되고 취소 가능한 이벤트로, ClipboardEvent 인터페이스로 디스패치한다.

    이벤트 디스패치 중 데이터 접근에 대한 구현 요구사항은 [HTML]에 정의되어 있다. 추가적인 클립보드 이벤트 전용 처리 규칙은 아래와 같다:

    왜 여기서 정의하는가? 왜 HTML 명세에 포함되지 않는가?

    1. 스크립트가 clearData() 또는 clear() 를 호출하고, DataTransfer 객체 내부 drag data store mode 플래그가 read/write이면,

       1. clear-was-called 플래그를 true로 설정한다. 인자가 주어지면 해당 인자를 types-to-clear 리스트에 추가한다.

    2. 스크립트가 setData()를 호출하거나 아이템을 수정하고, clear-was-called 플래그가 true이면,

       1. types-to-clear 리스트가 비어있으면,

          1. clear-was-called 플래그를 false로 한다.

       2. 그 외, setData()의 type 인자 또는 새 아이템의 drag data item type string이 types-to-clear 리스트에 있다면,

          1. 리스트에서 해당 항목을 제거하고, 리스트가 비어있으면 clear-was-called 플래그를 false로 한다.

    3. 스크립트가 getData()를 호출하거나 DataTransferItemList 에 접근하고 clipboard-entry가 설정되어 있으면,

       1. 클립보드 데이터의 시퀀스 번호가 clipboard-entry와 일치하는지 확인한다. 클립보드가 더 이상 동일한 항목을 포함하지 않으면 DataTransferItemList 객체의 내부 drag data store mode를 protected로 설정한다.

    경고! paste 이벤트를 감시하는 악성 스크립트가 사용자가 미래에 클립보드에 넣는 것을 무한 반복 루프를 통해 읽을 수 있습니다. 클립보드 시퀀스 번호를 지원하지 않는 플랫폼에서는 추가 제한이 필요합니다.

HTML 붙여넣기 이벤트 처리

입력

clipboard-part, 처리할 클립보드 파트

clipboard-event-data, 이 이벤트용 DataTransfer 객체

출력

없음

1. new-data를 새로운 DataTransferItem 으로, drag data item kind는 Plain Unicode string, drag data item type string은 text/html 또는 application/xhtml+xml로 한다.

2. clipboard-part에서 마크업을 추출하고, 관련 파서를 사용해 DOM 트리를 생성한다.

3. 마크업의 소스 URL이 알려져 있다면, HREF와 SRC 속성의 상대 URL을 소스 URL을 기준으로 모두 절대 URL로 변환해 해당 속성에 설정한다.

4. 마크업의 출처가 로컬 애플리케이션이라면, 로컬 파일이나 OS 클립보드의 다른 부분을 참조하는지 확인한다. 참조가 있다면, 서브파트 참조는 반드시 cid: URL 스킴([RFC2392])을 활용해 content-id 참조로 바꿔야 한다. 이를 위해 아래 단계를 따른다:

   이 단계가 필요한가? 내부 참조가 있는 다중 파트 지원 네이티브(플랫폼) 클립보드 구현이 존재하는가?

   이 기능은 꼭 필요한지, 그리고 크로스 플랫폼 테스트가 어렵기 때문에 위험에 처해있음.

   1. clipboard-event-data의 items 에 이미 참조된 파일 또는 클립보드 파트에 대한 항목이 있으면,

      1. itemNumber를 해당 항목의 인덱스로 설정한다.

   2. 그렇지 않으면,

      1. new-file-data를 새 DataTransferItem 객체로 하고, drag data item kind는 "file"로, drag data item type string은 파일 또는 클립보드 파트의 MIME 타입(알 수 없다면 application/octet-stream)으로 설정한다.

      2. file-info를 새 File 객체로 하며, name 은 HTML 속성 값의 이름 부분으로, lastModified 는 참조된 파일의 타임스탬프 또는 클립보드 파트라면 0으로 설정한다.

      3. new-file-data의 내부 File 객체를 file-info로 설정한다.

      4. new-file-data를 clipboard-event-data의 items 에 추가하고, itemNumber를 DataTransferItemList에서 해당 항목의 인덱스로 한다.

   3. 로컬 파일 또는 클립보드 파트를 참조하는 DOM 속성을 'cid:'와 itemNumber로 갱신한다.

5. 처리된 DOM을 직렬화하여 new-data에 생성된 HTML 코드로 갱신한다.

6. new-data를 clipboard-event-data의 items 에 추가한다.