Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Dokument: activeElement Eigenschaft

Baseline Widely available

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

Die activeElement-Eigenschaft des Document-Interfaces gibt das Element im DOM zurück, das Tastaturereignisse wie keydown und keyup empfängt. Dies ist normalerweise analog zu dem fokussierten Element.

Welche Elemente fokussierbar sind, variiert je nach Plattform und der aktuellen Konfiguration des Browsers. Zum Beispiel sind im Safari, entsprechend dem Verhalten von macOS, Elemente, die keine Texteingabeelemente sind, standardmäßig nicht fokussierbar, es sei denn, die Einstellung "Full Keyboard Access" ist in den Systemeinstellungen aktiviert.

Typischerweise kann ein Benutzer die Tab-Taste drücken, um den Fokus auf der Seite zwischen fokussierbaren Elementen zu bewegen, und Tastaturgesten wie Space oder Enter verwenden, um Klicks auf das fokussierte Element zu simulieren.

Hinweis: Fokus (welches Element Benutzereingabeereignisse empfängt) ist nicht dasselbe wie Auswahl (der aktuell hervorgehobene Teil des Dokuments). Sie können die aktuelle Auswahl mit window.getSelection() abrufen.

Wert

Das tiefste Element, das derzeit den Fokus hat.

  • Befindet sich das fokussierte Element innerhalb eines Schattenbaums im aktuellen Dokument (zum Beispiel, das fokussierte Element ist in einem iframe, und das aufrufende Dokument enthält dieses iframe), dann ist dies das Wurzelelement dieses Baums (in diesem Beispiel das iframe).
  • Befindet sich das fokussierte Element in einem Dokumentbaum, der nicht vom aktuellen Dokument abstammt (zum Beispiel, das fokussierte Element ist im Hauptdokument, und das aufrufende Dokument ist ein eingebettetes iframe), dann ist dies null.
  • Gibt es kein fokussiertes Element, so handelt es sich um Document.body oder Document.documentElement.

Beispiele

HTML

html
<p>Select some text from one of the text areas below:</p>

<form>
  <textarea name="ta-example-one" id="ta-example-one" rows="7" cols="40">
This is Text Area One. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec tincidunt, lorem a porttitor molestie, odio nibh iaculis libero, et accumsan nunc orci eu dui.</textarea
  >
  <textarea name="ta-example-two" id="ta-example-two" rows="7" cols="40">
This is Text Area Two. Fusce ullamcorper, nisl ac porttitor adipiscing, urna orci egestas libero, ut accumsan orci lacus laoreet diam. Morbi sed euismod diam.</textarea
  >
</form>

<p>Active element ID: <em id="output-element"></em></p>
<p>Selected text: <em id="output-text"></em></p>

JavaScript

js
function onMouseUp(e) {
  const activeTextarea = document.activeElement;
  const selection = activeTextarea.value.substring(
    activeTextarea.selectionStart,
    activeTextarea.selectionEnd,
  );

  const outputElement = document.getElementById("output-element");
  const outputText = document.getElementById("output-text");
  outputElement.textContent = activeTextarea.id;
  outputText.textContent = selection;
}

const textarea1 = document.getElementById("ta-example-one");
const textarea2 = document.getElementById("ta-example-two");
textarea1.addEventListener("mouseup", onMouseUp);
textarea2.addEventListener("mouseup", onMouseUp);

Ergebnis

Spezifikationen

Specification
HTML
# dom-documentorshadowroot-activeelement-dev

Browser-Kompatibilität

Siehe auch