EditContext: textupdate event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("EditContext API")}}{{SeeCompatTable}}

The textupdate event of the {{domxref("EditContext")}} interface fires when the user has made changes to the text or selection of an editable region that's attached to an EditContext instance.

This event makes it possible to render the updated text and selection in the UI, in response to user input.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("textupdate", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
ontextupdate = (event) => { }

Event type

A {{domxref("TextUpdateEvent")}}. Inherits from {{domxref("Event")}}.

Examples

Rendering the updated text on textupdate

In the following example, the textupdate event of the EditContext API is used to render the text a user enters in an editable <canvas> element.

html
<canvas id="editor-canvas"></canvas>
js
const canvas = document.getElementById("editor-canvas");
const ctx = canvas.getContext("2d");
const editContext = new EditContext();
canvas.editContext = editContext;

editContext.addEventListener("textupdate", (e) => {
  // When the user has focus on the <canvas> and enters text,
  // this event is fired, and we use it to re-render the text.
  console.log(
    `The user entered the text: ${e.text} at ${e.updateRangeStart}. Re-rendering the full EditContext text`,
  );
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.fillText(editContext.text, 10, 10);
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}