Baseline Widely available *
Das <textarea>
HTML Element repräsentiert ein mehrzeiliges Bearbeitungselement für Klartext. Es ist nützlich, wenn Sie Benutzern erlauben möchten, eine groÃe Menge an Freitext einzugeben, beispielsweise einen Kommentar in einem Bewertungs- oder Feedbackformular.
<label for="story">Tell us your story:</label>
<textarea id="story" name="story" rows="5" cols="33">
It was a dark and stormy night...
</textarea>
label,
textarea {
font-size: 0.8rem;
letter-spacing: 1px;
}
textarea {
padding: 10px;
max-width: 100%;
line-height: 1.5;
border-radius: 5px;
border: 1px solid #cccccc;
box-shadow: 1px 1px 1px #999999;
}
label {
display: block;
margin-bottom: 10px;
}
Das obige Beispiel demonstriert mehrere Funktionen von <textarea>
:
id
-Attribut, um das <textarea>
-Element aus Barrierefreiheitsgründen mit einem <label>
-Element zu verknüpfen.name
-Attribut, um den Namen des zugehörigen Datenpunkts festzulegen, der beim Absenden des Formulars an den Server übermittelt wird.rows
- und cols
-Attribute, mit denen Sie eine genaue GröÃe für das <textarea>
festlegen können. Das Setzen dieser Attribute ist eine gute Idee, um Konsistenz sicherzustellen, da sich die Standardwerte der Browser unterscheiden können.<textarea>
-Element gibt seinen Inhalt in HTML- und JavaScript-Kontexten unterschiedlich an:
<textarea>
zwischen den öffnenden und schlieÃenden Tags angegeben, nicht als value
-Attribut.<textarea>
-Elemente über eine value
-Eigenschaft, mit der der aktuelle Inhalt abgerufen oder festgelegt werden kann, und defaultValue
zum Abrufen und Festlegen des Anfangswertes (äquivalent zum Zugriff auf den Textinhalt des HTML-Elements).Das <textarea>
-Element akzeptiert auch mehrere gemeinsame Attribute von Form-<input>
s, wie autocapitalize
, autocomplete
, autofocus
, disabled
, placeholder
, readonly
und required
.
Dieses Element enthält die globalen Attribute.
autocapitalize
Steuert, ob eingegebener Text automatisch groÃgeschrieben wird und wenn ja, wie.
autocomplete
Steuert, ob eingegebener Text automatisch vom Browser vervollständigt werden kann. Mögliche Werte sind:
off
: Der Benutzer muss bei jeder Verwendung explizit einen Wert in dieses Feld eingeben, oder das Dokument liefert seine eigene Auto-Vervollständigungs-Methode; der Browser vervollständigt den Eintrag nicht automatisch.on
: Der Browser kann den Wert basierend auf Werten automatisch vervollständigen, die der Benutzer bei vorherigen Verwendungen eingegeben hat.<token-list>
: Eine geordnete Menge von autofill Detail-Token, die durch Leerzeichen getrennt sind, optional vorangestellt durch ein Segmentierungstoken, ein Rechnungs- oder Versandgruppentoken und/oder ein Token, das den Typ des Empfängers identifiziert.<textarea>
-Elemente, die das autocomplete
-Attribut nicht angeben, erben den autocomplete
on
- oder off
-Status, der auf dem <textarea>
-Formular-Owner gesetzt ist. Der Formular-Owner ist entweder das <form>
-Element, dessen Nachkomme das <textarea>
-Element ist, oder das Formularelement, dessen id
durch das form
-Attribut des Eingabeelements angegeben ist. Weitere Informationen finden Sie im autocomplete
-Attribut in <form>
.
autocorrect
Steuert, ob die automatische Rechtschreibkorrektur und Textverarbeitung aktiviert ist, während der Benutzer dieses textarea
bearbeitet. Erlaubte Werte sind:
on
Automatische Rechtschreibkorrektur und Textersetzungen aktivieren.
off
Automatische Rechtschreibkorrektur und Textersetzungen deaktivieren.
autofocus
Dieses Boolesche Attribut lässt Sie festlegen, dass ein Formularelement den Eingabefokus haben sollte, wenn die Seite geladen wird. Nur ein form assoziiertes Element in einem Dokument kann dieses Attribut spezifiziert haben.
cols
Die sichtbare Breite des Textelements, in durchschnittlicher Zeichenbreite. Wenn es angegeben ist, muss es eine positive ganze Zahl sein. Wird es nicht angegeben, ist der Standardwert 20
.
dirname
Dieses Attribut wird verwendet, um die Textausrichtung des Inhalts des Elements anzugeben. Weitere Informationen finden Sie im dirname
-Attribut.
disabled
Dieses boolesche Attribut gibt an, dass der Benutzer nicht mit dem Steuerelement interagieren kann. Wenn dieses Attribut nicht angegeben ist, erbt das Steuerelement seine Einstellung vom enthaltenen Element, z.B. <fieldset>
; wenn es kein enthaltenes Element gibt, wenn das disabled
-Attribut gesetzt wird, bleibt das Steuerelement aktiviert.
form
Das Formular-Element, mit dem das <textarea>
-Element verknüpft ist (sein âFormular-Ownerâ). Der Wert des Attributs muss die id
eines Formularelements im selben Dokument sein. Wenn dieses Attribut nicht angegeben ist, muss das <textarea>
-Element ein Nachkomme eines Formularelements sein. Dieses Attribut ermöglicht es Ihnen, <textarea>
-Elemente überall innerhalb eines Dokuments zu platzieren, nicht nur als Nachkommen von Formularelementen.
maxlength
Die maximale Zeichenkettenlänge (gemessen in UTF-16-Code-Einheiten), die der Benutzer eingeben kann. Wenn dieser Wert nicht angegeben ist, kann der Benutzer eine unbegrenzte Anzahl von Zeichen eingeben.
minlength
Die minimale Zeichenkettenlänge (gemessen in UTF-16-Code-Einheiten), die eingegeben werden muss.
name
Der Name des Steuerelements.
placeholder
Ein Hinweis an den Benutzer, was im Steuerelement eingegeben werden kann. Wagenrückläufe oder Zeilenumbrüche innerhalb des Platzhaltertextes müssen bei der Darstellung des Hinweises als Zeilenumbrüche behandelt werden.
Hinweis: Platzhalter sollten nur verwendet werden, um ein Beispiel für die Art von Daten zu zeigen, die in ein Formular eingegeben werden sollten; sie sind kein Ersatz für ein richtiges <label>
-Element, das an die Eingabe gebunden ist. Siehe <input>
-Labels für eine vollständige Erklärung.
readonly
Dieses boolesche Attribut gibt an, dass der Benutzer den Wert des Steuerelements nicht ändern kann. Anders als das disabled
-Attribut verhindert das readonly
-Attribut nicht, dass der Benutzer in das Steuerelement klickt oder es auswählt. Der Wert eines schreibgeschützten Steuerelements wird immer noch mit dem Formular übermittelt.
required
Dieses Attribut gibt an, dass der Benutzer vor dem Absenden eines Formulars einen Wert eingeben muss.
rows
Die Anzahl der sichtbaren Textzeilen für das Steuerelement. Wenn es angegeben ist, muss es eine positive ganze Zahl sein. Wird es nicht angegeben, ist der Standardwert 2.
spellcheck
Gibt an, ob das <textarea>
einer Rechtschreibprüfung durch den zugrunde liegenden Browser/OS unterzogen wird. Der Wert kann sein:
true
: Gibt an, dass das Element auf Rechtschreibung und Grammatik überprüft werden soll.default
: Gibt an, dass das Element gemäà einem Standardverhalten agieren soll, möglicherweise basierend auf dem eigenen spellcheck
-Wert des übergeordneten Elements.false
: Gibt an, dass das Element nicht auf Rechtschreibung geprüft werden soll.wrap
Gibt an, wie das Steuerelement den Wert für die Formularübermittlung umbrechen soll. Mögliche Werte sind:
hard
: Der Browser fügt automatisch Zeilenumbrüche (CR+LF) ein, sodass jede Zeile nicht länger als die Breite des Steuerelements ist; das cols
-Attribut muss angegeben werden, damit dies wirksam wirdsoft
: Der Browser stellt sicher, dass alle Zeilenumbrüche im eingegebenen Wert ein CR+LF
-Paar sind, aber es werden keine zusätzlichen Zeilenumbrüche zum Wert hinzugefügt.off
Nicht standardisiert : Wie soft
, ändert jedoch das Erscheinungsbild zu white-space: pre
, sodass Zeilensegmente, die cols
überschreiten, nicht umbrochen und das <textarea>
-Element horizontal scrollbar wird.Wenn dieses Attribut nicht angegeben ist, ist soft
der Standardwert.
<textarea>
ist ein ersetztes Element â es hat intrinsische Dimensionen, ähnlich einem Rasterbild. StandardmäÃig ist sein display
-Wert inline-block
. Im Vergleich zu anderen Formularelementen ist es relativ einfach zu stylen, wobei sein Box-Modell, seine Schriftarten, sein Farbschema usw. leicht mit regulärem CSS manipuliert werden können.
Styling HTML-Formulare bietet einige nützliche Tipps zum Styling von <textarea>
-Elementen.
Die HTML-Spezifikation definiert nicht, wo die Grundlinie eines <textarea>
ist, sodass verschiedene Browser sie an unterschiedliche Positionen setzen. Bei Gecko wird die <textarea>
-Basislinie auf der Basislinie der ersten Zeile des Textarea gesetzt, bei einem anderen Browser möglicherweise am unteren Rand des <textarea>
-Rahmens. Verwenden Sie vertical-align: baseline
nicht darauf; das Verhalten ist unvorhersehbar.
In den meisten Browsern sind <textarea>
-Elemente gröÃenveränderbar â Sie werden den Ziehgriff in der rechten unteren Ecke bemerken, mit dem die GröÃe des Elements auf der Seite verändert werden kann. Dies wird durch die resize
CSS-Eigenschaft gesteuert â das Ãndern der GröÃe ist standardmäÃig aktiviert, kann jedoch durch einen resize
-Wert von none
ausdrücklich deaktiviert werden:
textarea {
resize: none;
}
Styling von gültigen und ungültigen Werten
Gültige und ungültige Werte eines <textarea>
-Elements (z.B. solche innerhalb und auÃerhalb der durch minlength
, maxlength
oder required
festgelegten Grenzen) können mit den :valid
- und :invalid
-Pseudoklassen hervorgehoben werden. Zum Beispiel, um dem Textbereich eine andere Umrandung zu geben, je nachdem, ob er gültig oder ungültig ist:
textarea:invalid {
border: 2px dashed red;
}
textarea:valid {
border: 2px solid lime;
}
Beispiele Einfaches Beispiel
Das folgende Beispiel zeigt ein Textfeld mit einer festgelegten Anzahl an Zeilen und Spalten, einem Standardinhalt und CSS-Stilen, die verhindern, dass Benutzer das Element auf mehr als 500px Breite und 130px Höhe vergröÃern:
<textarea name="textarea" rows="5" cols="15">Write something here</textarea>
textarea {
max-height: 130px;
max-width: 500px;
}
Ergebnis Beispiel mit "minlength" und "maxlength"
Dieses Beispiel hat eine minimale und maximale Zeichenanzahl von 10 bzw. 20. Probieren Sie es aus und sehen Sie selbst.
<textarea name="textarea" rows="5" cols="30" minlength="10" maxlength="20">
Write something hereâ¦
</textarea>
textarea {
max-height: 130px;
max-width: 500px;
}
Ergebnis
Beachten Sie, dass minlength
den Benutzer nicht daran hindert, Zeichen zu entfernen, sodass die eingegebene Anzahl unter das Mindestmaà fällt, aber es macht den in das <textarea>
eingegebenen Wert ungültig. Beachten Sie auch, dass selbst wenn Sie einen minlength
-Wert gesetzt haben (zum Beispiel 3), ein leeres <textarea>
immer noch als gültig betrachtet wird, es sei denn, Sie haben auch das required
-Attribut gesetzt.
Dieses Beispiel hat einen Platzhalter gesetzt. Beachten Sie, wie er verschwindet, wenn Sie anfangen, in das Feld zu tippen.
<textarea
name="textarea"
rows="5"
cols="30"
placeholder="Comment text."></textarea>
textarea {
max-height: 130px;
max-width: 500px;
}
Ergebnis
Hinweis: Platzhalter sollten nur verwendet werden, um ein Beispiel für die Art von Daten zu zeigen, die in ein Formular eingegeben werden sollten; sie sind kein Ersatz für ein richtiges <label>
-Element, das an die Eingabe gebunden ist. Siehe <input>
-Labels für eine vollständige Erklärung.
Dieses Beispiel zeigt zwei <textarea>
-Elemente â eines ist readonly
und eines ist disabled
. Sie können den Inhalt beider Elemente nicht bearbeiten, aber das readonly
-Element ist fokussierbar und sein Wert wird in Formularen übermittelt. Der Wert des disabled
-Elements wird nicht übermittelt und es ist nicht fokussierbar.
<textarea name="textarea" rows="5" cols="30" readonly>
I am a read-only textarea.
</textarea>
<textarea name="textarea" rows="5" cols="30" disabled>
I am a disabled textarea.
</textarea>
textarea {
display: block;
resize: horizontal;
max-width: 500px;
}
Ergebnis Technische Zusammenfassung Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4