MathMLElement: focus()-Methode

Baseline

Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2023 browserübergreifend verfügbar.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die Methode focus() der Schnittstelle MathMLElement setzt den Fokus auf das angegebene MathML-Element, sofern es fokussiert werden kann. Das fokussierte Element empfängt standardmäßig Tastaturereignisse und ähnliche Ereignisse.

Standardmäßig scrollt der Browser das Element nach dem Fokussieren in den sichtbaren Bereich. Er kann das fokussierte Element auch visuell hervorheben (üblicherweise durch einen „Fokusring“ um das Element). Mit Optionen lässt sich das standardmäßige Scrollen deaktivieren und eine sichtbare Hervorhebung erzwingen. Wenn Sie focus() aus einem mousedown-Event-Handler aufrufen, müssen Sie event.preventDefault() aufrufen, damit der Fokus das MathMLElement nicht verlässt.

Syntax

focus()
focus(options)

Parameter

options Optional

Ein Objekt, das Aspekte des Fokussierungsvorgangs steuert. Dieses Objekt kann die folgenden Eigenschaften enthalten:

preventScroll Optional: Ein boolescher Wert, der angibt, ob der Browser das Dokument scrollen soll, um das neu fokussierte Element in den sichtbaren Bereich zu bringen. Der Wert false für preventScroll (die Standardeinstellung) bedeutet, dass der Browser das Element nach dem Fokussieren in den sichtbaren Bereich scrollt. Ist preventScroll auf true gesetzt, wird nicht gescrollt.

HTML

html

<div>
  <math>
    <msup id="myMath" tabindex="0">
      <mi>x</mi>
      <mn>2</mn>
    </msup>
  </math>
  <button id="focusButton">Focus the Math</button>
</div>

JavaScript

const mathElement = document.getElementById("myMath");

document.getElementById("focusButton").addEventListener("click", () => {
  mathElement.focus();
});