MathMLElement: focus() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Januar 2023⁩.

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

Standardmäßig scrollt der Browser nach dem Fokussieren zu dem Element und kann auch eine sichtbare Kennzeichnung des fokussierten Elements bereitstellen (typischerweise durch die Anzeige eines "Fokusrahmens" um das Element). Es werden Parameteroptionen bereitgestellt, um das standardmäßige Scrollen zu deaktivieren und eine sichtbare Kennzeichnung auf Elementen zu erzwingen. Wenn Sie focus() aus einem mousedown-Ereignishandler aufrufen, müssen Sie event.preventDefault() aufrufen, um zu verhindern, dass der Fokus das MathMLElement verlässt.

Syntax

focus()
focus(options)

Parameter

options Optional

Ein Objekt zur Steuerung von Aspekten des Fokussierungsvorgangs. 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 sichtbar zu machen. Ein Wert von false für preventScroll (der Standardwert) bedeutet, dass der Browser nach dem Fokussieren das Element in den sichtbaren Bereich scrollt. Wenn preventScroll auf true gesetzt ist, erfolgt kein Scrollen.

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();
});