HTMLElement: autocapitalize-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die autocapitalize-Eigenschaft des HTMLElement-Interfaces repräsentiert das Verhalten der Großschreibung für Benutzereingaben des Elements. Sie ist auf allen HTML-Elementen verfügbar, wirkt sich jedoch nicht auf alle aus, einschließlich:

<input>- und <textarea>-Elemente.
Jedes Element mit aktiviertem contenteditable.

autocapitalize beeinflusst das Verhalten beim Tippen auf einer physischen Tastatur nicht. Es betrifft das Verhalten anderer Eingabemechanismen wie virtuelle Tastaturen auf mobilen Geräten und Spracheingaben. Dies kann Benutzern helfen, die Dateneingabe schneller und einfacher zu gestalten, indem zum Beispiel automatisch der erste Buchstabe jedes Satzes großgeschrieben wird.

Es spiegelt den Wert des globalen HTML-Attributs autocapitalize wider.

Wert

Ein String, der das Großschreibungsverhalten für Benutzereingaben des Elements repräsentiert. Gültige Werte sind wie folgt:

none oder off: Es sollte keine automatische Großschreibung angewendet werden, d.h., alle Buchstaben sollten standardmäßig kleingeschrieben werden.
sentences oder on: Der erste Buchstabe jedes Satzes sollte standardmäßig großgeschrieben werden; alle anderen Buchstaben sollten kleingeschrieben werden.
words: Der erste Buchstabe jedes Wortes sollte standardmäßig großgeschrieben werden; alle anderen Buchstaben sollten kleingeschrieben werden.
characters: Alle Buchstaben sollten standardmäßig großgeschrieben werden.

Beispiele

Das folgende Beispiel zeigt, wie das Großschreibungsverhalten für Benutzereingaben über ein Skript gesteuert werden kann:

html

<div>Current capitalization behavior is: <span id="ac-label"></span></div>
<div id="ac-element" contenteditable="true" autocapitalize="default">
  input here
</div>
<select id="ac-controller" type="checkbox" checked>
  <option value="default">default</option>
  <option value="none">none</option>
  <option value="sentences">sentences</option>
  <option value="words">words</option>
  <option value="characters">characters</option></select
>Select the capitalization behavior

const label = document.getElementById("ac-label");
const element = document.getElementById("ac-element");
const controller = document.getElementById("ac-controller");

controller.addEventListener("input", (e) => {
  const behavior = e.target.value;
  label.textContent = behavior;
  element.autocapitalize = behavior;
});

Spezifikationen

Specification
HTML Standard # dom-autocapitalize-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

autocapitalize globales HTML-Attribut