textarea | NN 2 IE 3 DOM 1
Das textarea-Objekt spiegelt das textarea-Element wider und wird als Formularsteuerelement verwendet. Mit diesem Objekt können Sie einen Benutzer dazu zu bewegen, mehrere Textzeilen für die Übertragung an den Server einzugeben. Beachten Sie, dass die Eigenschaft innerHTML in der Macintosh-Version von Internet Explorer 4 nicht verfügbar ist. Von den unten aufgeführten Eigenschaften und Methoden sind nur einige wenige in älteren Browsern (vor IE 4 und Netscape 6) verfügbar, die noch nicht die Adressierung aller HTML-Elemente unterstützen. IE ab Version 5 unterstützt die gemeinsame Methode doScroll( ) für dieses Objekt.
HTML-Äquivalent
    <textarea>
Objektmodellreferenz
    [window.]document.formName.elementName
    [window.]document.forms[i].elements[j]
    [window.]document.getElementById("elementID")
Objektspezifische Eigenschaften
cols | dataFld | dataSrc | defaultValue | form
name | readOnly | rows | status | type
value | wrap |  |  |
Objektspezifische Methoden
createTextRange( ) | handleEvent( ) | select( )
Objektspezifische Ereignisbehandlungsroutineneigenschaften
Behandlungsroutine | NN | IE | DOM
onblur | 2 | 3 | --
onchange | 2 | 3 | --
onfocus | 2 | 3 | --
onkeydown | 4 | 4 | --
onkeypress | 4 | 4 | --
onkeyup | 4 | 4 | --
onscroll | -- | 4 | --
onselect | 2 | 3 | --

accessKey | NN nicht zutreffend IE 4 DOM 1
| Lesen/Schreiben
Dies ist eine einzelne Buchstabentaste, durch die ein Element (in manchen Browsern) den Fokus erhält oder ein Formularsteuerelement bzw. eine Link-Aktion aktiviert wird. Der Browser und das Betriebssystem bestimmen, ob zusammen mit der Buchstabentaste eine Zusatztaste (wie Strg, Alt oder Befehl) gedrückt werden muss, damit der Link aktiviert wird. In IE für Windows ab Version 5 und Netscape 6 muss gleichzeitig die Alt-Taste gedrückt werden, und bei der Buchstabentaste wird nicht zwischen Groß- und Kleinschreibung unterschieden. In IE für den Macintosh ab Version 5 und der Macintosh-Version von Netscape 6 funktioniert die Zugriffstaste nur in Verbindung mit der Ctrl-Taste.
Obwohl sie hier als gemeinsame Eigenschaft aufgeführt, wird sie streng genommen nicht in allen Implementierungen unterstützt. Netscape 6 (per W3C-DOM) erkennt diese Eigenschaft nur in Verbindung mit den folgenden Elementen: a, area, button, input, label, legend und textarea, IE 4 darüber hinaus für applet, body, div, embed, isindex, marquee, object, select, span, table und td (nicht jedoch für label und legend). IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen, weist in diesem Zusammenhang jedoch eine Besonderheit auf: Außer bei input und anderen formularbezogenen Elementen müssen Sie einem Element für IE ab Version 5 außerdem ein tabindex-Attribut mit einem beliebigen Wert oder einen beliebigen tabIndex-Eigenschaftswert zuweisen, damit der Benutzer in der Lage ist, ihm mithilfe der Schnellzugriffstaste den Fokus zu übergeben. In Netscape 7 hat eine Änderung des Eigenschaftswerts in einem Skript bisher keine Auswirkung auf das Verhalten der Benutzeroberfläche.
Beispiel
    document.links[3].accessKey = "n";
Wert
Einzelnes alphanumerisches Zeichen (oder ein Satzzeichen).
Standardwert
Leere Zeichenfolge.

blur( ) | NN 2 IE 3 DOM 1
Entfernt den Fokus vom aktuellen Objekt und löst damit das onblur-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode blur( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen. Die Zuweisung des Attributs onfocus="this.blur( );" zu einem Text-input-Element ist beispielsweise eine simple, aber effektive und rückwärtskompatible Möglichkeit, ein Feld für Browser zu deaktivieren, die keine eigene Funktion zum Deaktivieren von Elementen aufweisen.
Verwenden Sie die Methoden blur( ) und focus( ) vorsichtig in ein- und derselben Seite, da hierbei durch eingeblendete Warndialogfelder versehentlich Blur- und Fokus-Endlosschleifen ausgelöst werden können. Denken Sie außerdem daran, dass der Aufruf der Methode blur( ) eines Objekts bewirkt, dass ein anderes Objekt (möglicherweise das window-Objekt) ein onfocus-Ereignis empfängt.
Parameter
Keine.
Zurückgegebener Wert
Keiner.

clientLeft, clientTop | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Schreibgeschützt
Geben die linke und obere Koordinate des Elementinhalts innerhalb des Rechtecks bereit, das die Elementauffüllung enthält, jedoch mit geringfügigen Abweichungen bei den verschiedenen Betriebssystemversionen von IE. In IE für Macintosh nicht für alle Elementtypen verfügbar. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. Hilfreichere Informationen zur Positionierung von Inline-Elementen lassen sich im Allgemeinen über die Eigenschaften offsetLeft und offsetTop ermitteln (einschließlich Netscape 6). Bei CSS-positionierten Elementen verwenden Sie style-Objekteigenschaften wie left und top sowie (nur in IE) pixelLeft und pixelTop (auch zum Ändern der Position eines Elements).
Wert
Ein Pixelwert als ganze Zahl.
Standardwert
0

clientHeight, clientWidth | NN 7 IE 4 DOM nicht zutreffend
| Schreibgeschützt
Geben die Höhe und Breite des Elementinhalts zurück, jedoch mit geringfügigen Abweichungen hinsichtlich der Elementauffüllung bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. In IE für Macintosh nicht für alle Elementtypen verfügbar. Bei Netscape 7 sind die Werte Null, es sei denn, der Inhalt eines Elements ragt über den sichtbaren Bereich hinaus, in welchem Fall die Werte die Abmessungen des sichtbaren Bereichs (beim Element document.body beispielsweise den Inhaltsbereich des Browserfensters) angeben. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels.
Beispiel
    var midHeight = document.body.clientHeight/2;
Wert
Ein Pixelwert als ganze Zahl.
Standardwert
0

cols | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Legt die Breite des editierbaren Bereichs eines textarea-Elements fest. Dieser Wert stellt die Anzahl von Zeichen in einer nichtproportionalen Schrift dar, die innerhalb dieser Breite angezeigt werden können. Wenn die Schriftgröße durch Stylesheets beeinflusst werden kann, ändert sich die tatsächliche Breite entsprechend.
Beispiel
    document.forms[0].comments.cols = 60;
Wert
Eine ganze Zahl.
Standardwert
Hängt vom Browser und dem Betriebssystem ab.

dataFld | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Wird in IE für die Datenbindung verwendet, um den Spaltennamen einer Remote-Datenquelle der value-Eigenschaft eines textarea-Objekts zuzuweisen. Für das Element muss außerdem das Attribut datasrc gesetzt sein. Wenn sowohl dataFld als auch dataSrc auf eine leere Zeichenfolge gesetzt wird, wird die Bindung zwischen dem Element und der Datenquelle unterbrochen. Funktioniert in IE 5/Mac nur mit Textdateien als Datenquellen.
Beispiel
    document.myForm.myTextArea.dataFld = "description";
Wert
Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquellenspalte.
Standardwert
Keiner.

dataSrc | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Wird in IE für die Datenbindung verwendet, um die ID des object-Elements der Seite anzugeben, das das Datenquellenobjekt für den Remote-Datenzugriff lädt. Der Inhalt der Datenquelle wird mit dem datafld-Attribut angegeben. Wenn sowohl dataFld als auch dataSrc auf eine leere Zeichenfolge gesetzt wird, wird die Bindung zwischen dem Element und der Datenquelle unterbrochen. Funktioniert in IE 5/Mac nur mit Textdateien als Datenquellen.
Beispiel
    document.myForm.myTextArea.dataSrc = "DBSRC3";
Wert
Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquelle.
Standardwert
Keiner.

defaultValue | NN 2 IE 3 DOM 1
| Schreibgeschützt
Gibt den Standardtext für das textarea-Element an, das im Quellcode der Seite durch das Start- und das End-Tag gekennzeichnet ist.
Beispiel
    var txtAObj = document.forms[0].myTextArea;
    if (txtAObj.value != txtAObj.defaultValue ) {
        ...
    }
Wert
Ein beliebiger Zeichenfolgenwert.
Standardwert
Keiner.

disabled | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Legt fest, ob das Element für eine Benutzerinteraktion verfügbar ist. Wenn die Eigenschaft auf true gesetzt ist, kann das Element weder den Fokus erhalten noch durch den Benutzer geändert werden und wird in der Seite in der Regel grau hinterlegt dargestellt. In IE für Windows ab Version 5.5 ist diese Eigenschaft für alle HTML-Elementobjekte verfügbar. In IE 4 und IE 5 gilt sie nur für Formularsteuerelemente, während Netscape ab Version 6 die Eigenschaft für Formularsteuerelemente und das style-Elementobjekt erkennt. Das Namens-/Wertpaar eines deaktivierten Formularsteuerelements wird nicht zusammen mit dem Formular übermittelt.
Beispiel
    document.getElementById("myButton").disabled = true;
Wert
Boolescher Wert: true | false.
Standardwert
false

filters[ ] | NN nicht zutreffend IE 4 DOM nicht zutreffend
Gibt ein Array aller filter-Objekte zurück, die im aktuellen Dokument enthalten sind. Gilt nur für die folgenden Elementobjekte: bdo, body, button, div, fieldset, img, input, marquee, rt, ruby, span, table, td, textarea und th. Informationen zur Referenzierungssyntax finden Sie in der Abhandlung des filter-Objekts.
Wert
Array mit filter-Objektreferenzen.
Standardwert
Array mit einer Länge von Null.

focus( ) | NN 2 IE 3 DOM 1
Übergibt den Fokus an das aktuelle Objekt und löst damit das onfocus-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode focus( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen.
Um einem Textfeld den Fokus zuzuweisen und zugleich den in diesem Feld enthaltenen Text zu markieren, wenden Sie die Methoden focus( ) und select( ) nacheinander auf das Element an. Wenn dies unmittelbar nach einer Veränderung im Fenster geschehen soll (z. B. nachdem ein Wardialogfeld geschlossen wurde), stellen Sie die beiden Methoden in eine separate Funktion und rufen Sie diese im Anschluss an die alert( )-Methode des Dialogfelds über die Methode setTimeout( ) auf. Auf diese Weise können Sie gewährleisten, dass IE/Windows die Anweisungen in der richtigen Reihenfolge ausführt.
Parameter
Keine.
Zurückgegebener Wert
Keiner.

form | NN 2 IE 3 DOM 1a
| Schreibgeschützt
Gibt eine Referenz auf das form-Element zurück, das das aktuelle Element enthält. Während der Verarbeitung eines von diesem Element stammenden Ereignisses hat die Ereignisbehandlungsroutinenfunktion automatisch Zugriff auf das select-Element (als target- oder srcElement-Eigenschaft des Ereignisobjekts). Durch Lesen der form-Eigenschaft kann das Skript problemlos auf andere Steuerelemente innerhalb desselben Formulars zugreifen.
Beispiel
    var theForm = evt.srcElement.form;
Wert
form-Elementobjektreferenz
Standardwert
Keiner.

name | NN 2 IE 3 DOM 1
| Lesen/Schreiben
Dies ist der dem Formularsteuerelement zugeordnete Bezeichner. Der Wert dieser Eigenschaft wird beim Senden des Formulars an den Server als eine Hälfte des Namens-/Wertpaars übertragen. Namen werden dem Benutzer nicht angezeigt, da die Beschriftungen für Steuerelemente, abhängig von der Art des Steuerelements, über andere Wege zugewiesen werden. Namen von Formularsteuerelementen können auch durch Referenzen in Skripts mit den Objekten verknüpft werden. Obwohl in modernen Standards das id-Attribut bevorzugt wird, setzen viele Browser beim Übertragen des Wertes eines Steuerelements noch immer voraus, dass diesem ein name-Attribut zugeordnet ist.
Beispiel
    document.orderForm.myTextArea.name = "customerComment";
Wert
Ein von der Groß-/Kleinschreibung abhängiger Bezeichner, der den Regeln der Bezeichnerbenennung folgt: Er darf keine Leerzeichen enthalten, nicht mit einer Ziffer beginnen und sollte keine Satzzeichen enthalten (mit Ausnahme des Unterstrichs).
Standardwert
Keiner.

readOnly | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Gibt an, ob das Formularelement vom Benutzer bearbeitet werden kann. Ein Formularsteuerelement, dessen readOnly-Eigenschaft auf true gesetzt ist, kann zwar nicht vom Benutzer geändert werden, Änderungen durch Skripts sind jedoch möglich.
Beispiel
    document.forms[0].myTextArea.readOnly = "true";
Wert
Boolescher Wert: true | false.
Standardwert
false

rows | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Legt die Höhe des textarea-Elements basierend auf der Anzahl der Textzeilen fest, die ohne einen Bildlauf angezeigt werden sollen. Dieser Wert stellt die Anzahl der Zeichenzeilen in einer einzelnen Schriftart dar, die in der Höhe angezeigt werden können, ohne dass die Bildlaufleiste aktiviert wird. Wenn die Schriftgröße durch Stylesheets beeinflusst werden kann, ändert sich die tatsächliche Höhe entsprechend.
Beispiel
    document.forms[0].comments.rows = 6;
Wert
Eine ganze Zahl.
Standardwert
2 (IE/Windows); 1 (IE/Macintosh); -1 (Netscape 6, wenn das Attribut oder die Eigenschaft nicht gesetzt ist).

scrollHeight, scrollWidth | NN 7 IE 4 DOM nicht zutreffend
| Schreibgeschützt
Diese Eigenschaften wurden in IE 4 ursprünglich für Elemente implementiert, die entweder selbst einen Bildlauf ausführen oder den Bildlauf eines Elements beeinflussen (body, button, caption, div, fieldset, legend, marquee und textarea), und geben die Abmessungen eines Elements in Pixeln zurück, auch wenn dieses größer ist als der sichtbare Bereich des Browserfensters. Insofern unterscheiden sie sich von den Eigenschaften clientHeight und clientWidth für rollbare Elemente, die nur die Abmessungen sichtbarer Anteile des Elements zurückgeben. IE für den Macintosh interpretiert den Zweck der Bildlaufeigenschaften anders und gibt die Maße der sichtbaren Elementbereiche zurück.
In IE für Windows weisen seit Version 5 alle HTML-Elemente diese Eigenschaften auf, und die Werte für nicht rollende Elemente sind mit denen der Eigenschaften offsetHigh und offsetWidth identisch. Netscape 7 implementiert diese Eigenschaften für alle Elemente und gibt die Höhe und Breite des Elements zurück, unabhängig davon, ob es sich innerhalb oder außerhalb des sichtbaren Bereichs befindet. Wichtig ist hier, dass für Schlüsselelemente, wie z. B. body, die Eigenschaften unterschiedliche Dinge bedeuten und den plattformübergreifenden Betrieb stören können.
Beispiel
    var midPoint = document.body.scrollHeight/2;
Wert
Eine positive ganze Zahl oder Null.
Standardwert
Keine.

scrollLeft, scrollTop | NN 7 IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Stellt den Abstand in Pixeln zwischen dem tatsächlichen linken oder oberen Rand des physischen Inhalts eines Elements und dem linken oder oberen Rand des sichtbaren Teils des Inhalts bereit. Durch Festlegen dieser Eigenschaften können Sie ein Skript verwenden, um den Bildlauf von Inhalten in einem rollbaren Container einstellen, z. B. einen Text in einem textarea-Element oder ein gesamtes Dokument in einem Browserfenster bzw. einem Frame. Können die Inhalte nicht gerollt werden, sind beide Werte Null. Wenn Sie die Eigenschaft scrollTop beispielsweise auf 15 setzen, rollt das Dokument um 15 Pixel im Fenster nach oben; die Eigenschaft scrollLeft wird nicht beeinflusst, soweit sie nicht ausdrücklich geändert wird. Die Eigenschaftswerte ändern sich, wenn der Benutzer die Bildlaufleisten anpasst. Dies ist für bestimmte ereignisgesteuerte Positionierungsaufgaben in IE für Windows von Bedeutung, da sich das Koordinatensystem für Ereignis-Offset-Messungen auf den sichtbaren Bereich einer Seite im Browserfenster bezieht. Sie müssen document.body-Bildlauffaktoren hinzufügen, um Ereigniskoordinaten an den Positionen der Body-Inhalte auszurichten (siehe das Beispiel zum Ziehen von Elementen in Kapitel 6). In IE für Windows ab Version 5 sind die Eigenschaften scrollLeft und scrollTop für alle HTML-Elementobjekte verfügbar, nicht rollbare Elemente weisen jedoch für beide Eigenschaften den Wert Null auf.
Beispiel
    document.body.scrollTop = 40;
Wert
Eine positive ganze Zahl oder Null.
Standardwert
0

status | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Diese Eigenschaft ist in IE implementiert, hat aber keine Auswirkung auf das textarea-Objekt.
Wert
Boolescher Wert: true | false oder null.
Standardwert
null

type | NN 3 IE 4 DOM 1
| Schreibgeschützt
Gibt den Typ des Formularsteuerelements zurück. Der Wert wird ausschließlich in Kleinbuchstaben zurückgegeben. Es kann notwendig sein, alle Formularsteuerelemente einzeln auf ihren Typ hin zu durchsuchen, um bestimmte Typen aufzufinden, die Sie in einer bestimmten Weise verarbeiten möchten (z. B. alle Formularsteuerelemente des Typs "textarea" entleeren, während alle anderen Steuerelemente unberührt bleiben sollen).
Beispiel
    if (document.forms[0].elements[3].type == "textarea") {
        ...
    }
Wert
Eine der folgenden Konstanten als Zeichenfolge: button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
Standardwert
textarea

value | NN 2 IE 3 DOM 1
| Lesen/Schreiben
Legt den aktuellen Wert fest, der dem Formularsteuerelement zugeordnet ist, das mit dem Namens-/Wertpaar des Elements gesendet wird. Alle Werte sind Zeichenfolgen.
Beispiel
    var comment = document.forms[0].myTextArea.value;
Wert
Zeichenfolge.
Standardwert
Keiner.

wrap | NN nicht zutreffend IE 4 DOM nicht zutreffend
| Lesen/Schreiben
Gibt an, ob der Browser Text in einem textarea-Element umbrechen und weiche Zeilenumbrüche beim Senden an den Server durch Wagenrückläufe ersetzen soll. Mit dem Wert hard wird der Wortumbruch aktiviert. Weiche Zeilenumbrüche werden in dem an den Server übertragenen Wert in CR-LF-Zeichen (Wagenrückläufe mit Zeilenschaltung) umgewandelt. Der Wert soft aktiviert den Zeilenumbruch, sendet jedoch keine CR-LF-Zeichen mit dem im Formular enthaltenen Text an den Server. Der Wert off deaktiviert den Wortumbruch.
Beispiel
    document.forms[0].comments.wrap = "soft";
Wert
Eine der folgenden Konstanten (als Zeichenfolge): hard | off | soft.
Standardwert
soft

createTextRange( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend
Erstellt ein TextRange-Objekt aus dem Inhalt des textarea-Objekts. Weitere Informationen finden Sie unter dem Objekt TextRange.
Zurückgegebener Wert
TextRange-Objekt.

handleEvent( ) | NN |4| IE nicht zutreffend DOM nicht zutreffend
handleEvent(event) |
Weist das Objekt an, ein Ereignis, dessen Spezifikationen als Parameter an die Methode übergeben werden, zu akzeptieren und zu verarbeiten. Das Objekt muss eine Ereignisbehandlungsroutine für den Ereignistyp besitzen, um das Ereignis verarbeiten zu können. Nur Navigator 4.
Parameter
Ein event-Objekt von Navigator 4.
Zurückgegebener Wert
Keiner.

select( ) | NN 2 IE 3 DOM 1
Wählt den gesamten Text aus, der im Formularelement angezeigt wird. Informationen dazu, wie Sie den Einfügepunkt in IE an eine bestimmte Stelle innerhalb eines textarea-Elements setzen, finden Sie in der Abhandlung des TextRange-Objekts.
Parameter
Keine.
Zurückgegebener Wert
Keiner.

tabIndex | NN 6 IE 4 DOM 1
| Lesen/Schreiben
Dies ist eine Zahl, die die Position dieses Elements innerhalb der Tabulatorreihenfolge aller aktivierbaren Elemente im Dokument angibt. Für die Tabulatorreihenfolge gelten sehr strenge Regeln. Elemente, deren tabIndex-Eigenschaften Werte (nicht Null) zugewiesen wurden, befinden sich in der Reihenfolge an erster Stelle, wenn ein Benutzer die Tabulatortaste auf einer Seite verwendet. Der Fokus beginnt bei dem Element mit dem niedrigsten tabIndex-Wert und folgt der Reihenfolge bis zum höchsten Wert, unabhängig von der physischen Position eines Objekts auf der Seite oder in einem Dokument. Falls zwei Elemente die gleichen tabIndex-Werte aufweisen, erhält das Element, das zuerst im Dokument erscheint, auch zuerst den Fokus. Dann kommen alle Elemente, die entweder die Eigenschaft tabIndex nicht unterstützen oder deren Wert auf Null gesetzt ist. Diese Elemente werden in der Reihenfolge aktiviert, in der sie im Dokument angeordnet sind.
Im W3C-DOM und in Netscape 6 ist die Eigenschaft tabIndex auf folgende Elementobjekte beschränkt: a, area, button, input, object, select und textarea. IE 4 unterstützt es darüber hinaus für die Elemente applet, body, div, embed, isindex, marquee, span, table und td. IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen. Ein negativer Wert entfernt ein Element (nur in IE) vollständig aus der Tabulatorreihenfolge.
Da Hyperlinks und Anker in der Mac-Version von IE 4 nicht über die Tabulatortaste zu erreichen sind, wird die Eigenschaft tabIndex bei a-Elementen in dieser Version ignoriert.
Beispiel
    document.getElementById("link3").tabIndex = 6;
Wert
Eine ganze Zahl.
Standardwert
0