input (type="text") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||
Das text-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut auf "text" gesetzt ist. Dieses Objekt nutzen Sie, um einen Benutzer zu zwingen, einzelne Textzeilen für die Übertragung an den Server einzugeben. |
||||||||||||||||||||||||||||||||
HTML-Äquivalent | ||||||||||||||||||||||||||||||||
<input type="text"> |
||||||||||||||||||||||||||||||||
Objektmodellreferenz | ||||||||||||||||||||||||||||||||
[window.]document.formName.elementName [window.]document.forms[i].elements[i] [window.]document.getElementById("elementID") |
||||||||||||||||||||||||||||||||
Objektspezifische Eigenschaften | ||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||
Objektspezifische Methoden | ||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||||||||||||||||||||||||||||||||
|
dataFld | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Wird in IE 4 für die Datenbindung verwendet, um den Spaltennamen einer Remote-Datenquelle mit der Eigenschaft value eines text-Objekts zu verknüpfen. 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.myText.dataFld = "price"; |
|
Wert | |
Von der Groß-/Kleinschreibung abhängige Zeichenfolge mit dem 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.myText.dataSrc = "DBSRC3"; |
|
Wert | |
Von der Groß-/Kleinschreibung abhängige Zeichenfolge mit dem Bezeichner der Datenquelle. |
|
Standardwert | |
Keiner. |
defaultValue | NN 2 IE 3 DOM 1 |
Schreibgeschützt | |
Der Standardtext für das Texteingabeelement entsprechend der Einstellung des value-Attributs. |
|
Beispiel | |
var txtObj = document.forms[0].myText; if (txtObj.value != txtObj.defaultValue ) { ... } |
|
Wert | |
Zeichenfolgenwert. |
|
Standardwert | |
Keiner. |
form | NN 2 IE 3 DOM 1 |
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 input-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. |
maxLength | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die maximale Anzahl der Zeichen an, die in ein input-Textelement eingegeben werden kann. In der Praxis geben Browser einen Signalton oder eine andere Warnung aus, wenn ein eingegebenes Zeichen den Wert maxLength überschreitet. Zwischen den Eigenschaften maxLength und size besteht keine Wechselbeziehung. Wenn der Wert von maxLength mehr Zeichen zulässt, als für die definierte Elementgröße möglich sind, kann das Feld im Browser horizontal gerollt werden, um es zu bearbeiten bzw. Text einzugeben (dies ist für den Benutzer jedoch umständlich). |
|
Beispiel | |
document.entryForm.myText.maxLength = 35; |
|
Wert | |
Ganzzahliger Wert. |
|
Standardwert | |
Unbegrenzt. |
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 dem Formularsteuerelement ein name-Attribut zugeordnet ist. |
|
Beispiel | |
document.orderForm.myText.name = "lastName"; |
|
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 |
Schreibgeschützt | |
Legt fest, ob das Element auf der Seite 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 | |
if (document.forms[0].myText.readOnly) { ... } |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
false |
size | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt grob gesagt die Textbreite in Zeichen an, für die das Eingabefeld ausgelegt werden muss. In der Praxis kann der Browser jedoch nicht immer die genaue Breite im Voraus bestimmen. Weitere Informationen finden Sie in der Abhandlung des size-Attributs für das input-Element in Kapitel 8. Bei diesem Element gibt es keine Wechselbeziehung zwischen den Eigenschaften size und maxLength. |
|
Beispiel | |
document.forms[0].myText.size = 12; |
|
Wert | |
Eine ganze Zahl. |
|
Standardwert | |
20 |
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 bei einer Suche nach bestimmten Typen zu durchlaufen, um eine Verarbeitung auszuführen (z. B. das Entfernen von Inhalten aus allen Formularsteuerelementen des Typs "text", während alle anderen Steuerelemente unberührt bleiben). |
|
Beispiel | |
if (document.forms[0].elements[3].type == "text") { // process text input type here } |
|
Wert | |
Eine der folgenden Konstanten als Zeichenfolge: button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea. |
|
Standardwert | |
text |
value | NN 2 IE 3 DOM 1 |
Lesen/Schreiben | |
Gibt den aktuellen Wert an, der mit dem Formularsteuerelement verknüpft ist, das mit dem Namens-/Wertpaar des Elements gesendet wird. Alle Werte sind Zeichenfolgen (Strings). Dies bedeutet, dass Skripts, die Textfeldwerte für mathematische Operationen verwenden (insbesondere Additionen), die Zeichenfolgen über die Funktion parseInt( ) oder parseFloat( ) in Zahlen konvertieren müssen, bevor die mathematischen Operationen ausgeführt werden können. Wenn Sie der Eigenschaft value eines Textfelds eine Zahl zuweisen, konvertiert der Browser den Datentyp automatisch in eine Zeichenfolge (String). |
|
Beispiel | |
document.forms[0].myText.value = "franken"; |
|
Wert | |
Zeichenfolge. |
|
Standardwert | |
Keiner. |
createTextRange( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Erstellt ein TextRange-Objekt aus dem Inhalt des text-Objekts. Weitere Informationen finden Sie unter dem Objekt TextRange. |
|
Parameter | |
Keine. |
|
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 | |
|
|
Zurückgegebener Wert | |
Keiner. |
select( ) | NN 2 IE 3 DOM 1 |
Wählt den gesamten Text aus, der im Formularelement angezeigt wird. Vor der select( )-Methode sollten Sie die Methode focus( ) aufrufen. Darüber hinaus sollten Sie, um mögliche Probleme in IE für Windows zu vermeiden, die focus( )- und select( )-Methodenanweisungen in eine separate Funktion stellen und diese mit einer Verzögerung von ungefähr 0 bis 50 Millisekunden über die setTimeout( )-Methode aufrufen. Auf diese Weise geben Sie dem Browser Zeit, vor dem Auswählen des Inhalts das Fenster zu aktualisieren. |
|
Parameter | |
Keine. |
|
Zurückgegebener Wert | |
Keiner. |