HTMLElement: input 이벤트

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/ko/web/api/element/index.md)

input 이벤트는 <input>, <select>, <textarea> 요소의 value가 바뀔 때 발생합니다.

input은 또한 contenteditable이나 designMode가 활성화된 요소에서도 발생합니다. contenteditabledesignMode에서의 이벤트 대상은 '편집 호스트'가 됩니다. 이 두 특성이 여러 특성에 적용된 경우, 편집할 수 없는 부모를 둔 가장 가까운 조상 요소이 편집 호스트입니다.

type=checkbox 또는 type=radio<input> 요소에서는 HTML Living Standard 명세에 따라 사용자가 컨트롤을 토글할 때마다 input 이벤트가 발생해야 합니다. 하지만 역사적으로 이 명세가 항상 맞는 것은 아니었습니다. 호환성을 먼저 확인하세요. 이 요소들에서는 change 이벤트로 대체하는 방법도 있습니다.

<textarea>와 텍스트 입력을 허용하는 <input>(type=text, type=tel, ...)에서의 이벤트 인터페이스는 InputEvent고, 나머지 요소에서는 Event입니다.

참고: input 이벤트는 요소의 value가 변할 때마다 발생합니다. change 이벤트는 엔터 키를 누르거나 리스트에서 옵션을 선택하는 등 변경점을 '반영'해야 발생한다는 점에서 다릅니다.

구문

이벤트 이름을 addEventListener() 등의 메서드에 제공하거나, 이벤트 처리기 속성을 사용하세요.

js
addEventListener("input", (event) => {});

oninput = (event) => {};

이벤트 유형

일반 Event.

예제

이 예제에서는 <input> 요소의 값을 바꿀 때마다 기록을 남깁니다.

HTML

html
<input placeholder="텍스트 입력" name="name" />
<p id="values"></p>

JavaScript

js
const input = document.querySelector("input");
const log = document.getElementById("values");

input.addEventListener("input", updateValue);

function updateValue(e) {
  log.textContent = e.target.value;
}

결과

명세서

Specification
UI Events
# event-type-input
HTML Standard
# handler-oninput

브라우저 호환성

BCD tables only load in the browser

같이 보기