입력 이벤트 레벨 2

이 문서는 편집과 관련된 2가지 이벤트 - input 및 beforeinput에 대한 확장 사항을 설명하며, 이는 UI 이벤트 명세 [UI-EVENTS]에 정의되어 있습니다. 이러한 이벤트의 목적은 저자가 편집이 발생하기 전후에 기본 편집 동작을 이해하거나 재정의할 수 있도록 하는 것입니다.

비규범적으로 표시된 섹션뿐만 아니라, 이 명세서의 모든 작성 지침, 다이어그램, 예시, 참고 사항은 비규범적입니다. 그 외의 모든 내용은 규범적입니다.

이 문서에서 MAY, MUST, MUST NOT라는 핵심 단어는 BCP 14 [RFC2119] [RFC8174] 에서 설명된 대로, 이와 같이 모두 대문자로 표시된 경우에만 해당 의미로 해석되어야 합니다.

의도 표현

사용자는 키보드, IME, 음성 또는 유사한 방법을 통해 특정 편집 작업을 실행하려는 의도를 표현할 수 있습니다. 특정 입력 동작은 플랫폼별 관례에 따라 의도와 매핑됩니다.

킬 버퍼

이 정의는 규범적이지 않습니다.

킬 버퍼는 클립보드와 분리된 리치텍스트 콘텐츠의 메모리 저장소로, 특정 삭제 명령을 통해 삭제된 콘텐츠를 임시 저장할 수 있습니다. 사용자는 킬 버퍼에 저장된 콘텐츠로 현재 선택 영역을 yank 명령을 통해 대체할 수 있습니다.

이 섹션은 규범적이지 않습니다.

웹 기반 텍스트 에디터를 만들기 위해서는 브라우저 코드 외에도 상당한 양의 JavaScript가 필요합니다. 그 이유는 다음과 같습니다:

1. 브라우저마다 모든 편집 작업을 동일하게 처리하지 않습니다.
2. 브라우저가 특정 편집 작업을 처리하는 방식에 종종 버그가 있습니다.
3. 각 사이트는 특정 편집 작업을 처리하는 방식에 대해 사용자 지정 선호도를 가질 수 있습니다.
4. 브라우저에서 고급 텍스트 편집 기능 개발은 Extensible Web Manifesto에 명시된 원칙을 따르지 않았으며, 이러한 기능 개발이 웹 개발자 커뮤니티의 요구와 항상 조율되어 이루어진 것은 아닙니다.

이 명세는 웹 개발자가 beforeinput 이벤트를 통해 텍스트 편집과 관련된 모든 사용자 입력에 대한 브라우저 처리 방식을 재정의하고, input 이벤트를 통해 사용자 입력으로 인해 브라우저가 DOM에 변경한 내용을 모니터링할 수 있는 간단한 방법을 제공하여 이러한 문제를 완화하고자 합니다.

이 섹션은 규범적이지 않습니다.

1. 모든 브라우저에 접근할 수 없는 상황에서 사용자가 텍스트를 굵게 표시할 때 <b> 태그 대신 <strong> 태그를 사용하는 JavaScript 텍스트 에디터 만들기.
2. JavaScript가 편집된 텍스트 변경 사항을 DOM에 렌더링하는 백엔드 데이터 모델과 함께 동작하는 JavaScript 텍스트 에디터 만들기.
3. JavaScript 에디터에서 일부 리치텍스트 편집만 허용(예: 굵게만 허용, 이탤릭은 허용하지 않음).
4. 사용자들이 각기 다른 브라우저에서 의도를 표현하는 방식이 다르더라도 JavaScript가 사용자 의도에 따라 DOM 변경 사항을 렌더링하는 협업 에디터 만들기.
5. 일부 사용자는 텍스트 추가·삭제만 가능하고, 다른 사용자는 특정 서식만 추가·삭제할 수 있는 다양한 사용자 접근 옵션을 가진 JavaScript 에디터 만들기.

입력 이벤트는 사용자가 마크업을 편집하려고 시도하기 전(beforeinput 이벤트)과 후(input 이벤트)에 전송됩니다. 여기에는 콘텐츠 삽입 및 삭제, 서식 변경이 포함됩니다.

입력 이벤트는 디스패치되어 편집 호스트 역할을 하는 요소(예: contenteditable 속성이 설정된 요소, textarea 요소, input 요소 중 텍스트 입력이 허용되는 요소)에서 발생합니다.

WebIDLpartial interface InputEvent {
   readonly attribute DataTransfer? dataTransfer;
   sequence<StaticRange> getTargetRanges();
};

partial dictionary InputEventInit {
   DataTransfer? dataTransfer = null;
   sequence<StaticRange> targetRanges = [];
};

조합의 시작은 compositionstart 이벤트를 디스패치하여 표시됩니다.

조합 세션 동안 텍스트 조합 시스템이 활성 텍스트 구절을 업데이트할 때마다 compositionupdate 이벤트가 디스패치됩니다.

각 compositionupdate 이벤트 이후에 beforeinput과 input 이벤트 쌍이 디스패치됩니다. beforeinput 및 input 이벤트는:

• 취소 불가
• inputType이 "insertCompositionText"로 설정됨
• data 속성이 compositionupdate 이벤트의 값과 동일함
• targetRange가 조합의 활성 텍스트 구절을 둘러쌈

활성 텍스트 구절의 DOM 내용은 beforeinput 이벤트가 디스패치된 후, input 이벤트가 디스패치되기 전에 업데이트됩니다.

조합 세션의 끝은 compositionend 이벤트를 디스패치하여 표시됩니다.

"insertFromPaste" beforeinput 이벤트가 디스패치될 때, 반드시 그 전에 paste [CLIPBOARD-APIS] 이벤트가 있어야 합니다.

이 섹션은 규범적이지 않습니다.

이 기능은 기존 이벤트(예: keydown 및 keypress [UI-EVENTS] 이벤트)를 통해 이미 이용 가능한 지문 채취 [fingerprinting-guidance] 기법 외에는 알려진 보안 또는 개인정보 영향이 없습니다.

만약 이 기능이 기존 이벤트를 대체한다면, 사용자의 의도가 기록되고, 사용자가 이 의도를 표현하는 데 사용한 특정 하드웨어 유형이 기록되지 않으므로 지문 채취 [fingerprinting-guidance] 기법의 감소로 이어질 수 있습니다.

Michael Aufreiter, Adrian Bateman, Oliver Buchtala, Robin Berjon, Enrica Casucci, Bo Cupp, Domenic Denicola, Emil Eklund, Olivier Forget, Aryeh Gregor, Marijn Haverbeke, Yoshifumi Inoue, Koji Ishii, Gary Kacmarcik, Ian Kilpatrick, Frederico Caldeira Knabben, Takayoshi Kochi, Piotrek Koszuliński, Travis Leithead, Grisha Lyukshin, Miles Maxfield, Chaals McCathie Nevile, Masayuki Nakano, Ryosuke Niwa, Julie Parent, Ben Peters, Florian Rivoal, Morgan Smith, Hallvord R. M. Steen, Johan Sörlin, Cristian Talau, Dave Tapuska, Ojan Vafai, Léonie Watson, Xiaoqian Wu, Chong Zhang, Joanmarie, 그리고 Editing Taskforce의 모든 분들께 의견과 피드백에 감사드립니다.