TextEvent

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The TextEvent interface is a legacy UI event interface for reporting changes to text UI elements.

Note: TextEvent events have been superseded by events such as input, beforeinput, keypress, keyup, and keydown.

Instance properties

This interface also inherits properties from its parent UIEvent, and indirectly from Event.

TextEvent.data Read only Deprecated: Indicates the data associated with the event.

Instance methods

TextEvent.initTextEvent() Deprecated: Populates the values of this (new) TextEvent with the given parameters.

Events list

The following is a list of all TextEvent events:

textinput

Examples

Listen for text input events

You can register a listener for text input events using EventTarget.addEventListener() as follows:

element.addEventListener(
  "textInput",
  (event) => {
    // …
  },
  false,
);

Simple logger showing input events

This example listens for a number of events that are fired on an input, including textInput. The event type and the event data are logged, allowing you to see where textInput is emitted relative to the other events such as those generated by key presses.

HTML

html

<input placeholder="Enter some text" name="name" />

<pre id="log"></pre>

#log {
  height: 140px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

const input = document.querySelector("input");

input.addEventListener("keypress", updateValue);
input.addEventListener("keyup", updateValue);
input.addEventListener("keydown", updateValue);
input.addEventListener("input", updateValue);
input.addEventListener("beforeinput", updateValue);
input.addEventListener("textInput", updateValue);

function updateValue(e) {
  log(`${e.type}: ${e.data}`);
}

Result

Specifications

Specification
UI Events # legacy-textevent-events

Browser compatibility

BCD tables only load in the browser