input (type="button")NN 2 IE 3 DOM 1

Das button-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut mit "button" gesetzt wurde. Der Text für die Beschriftung der Schaltfläche stammt aus dem Attribut und der Eigenschaft value. Dieses Element ähnelt dem button-Element, weist jedoch auch einige wesentliche Unterschiede auf. Ausführliche Informationen zu den unterschiedlichen Merkmalen finden Sie in der Beschreibung des HTML-Elements button in Kapitel 8.

 
HTML-Äquivalent
 
<input type="button">
 
Objektmodellreferenz
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
Objektspezifische Eigenschaften
 
dataFlddataSrcformnametypevalue
 
Objektspezifische Methoden
 
createTextRange( )handleEvent( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften
 
BehandlungsroutineNNIEDOM
onblur642
onclick232
onfocus642
onmousedown442
onmousemove642
onmouseout642
onmouseover642
onmouseup442
dataFldNN 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 button-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.myButton.dataFld = "linkURL";
 
Wert

Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquellenspalte.

 
Standardwert

Keiner.

dataSrcNN 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.myButton.dataSrc = "DBSRC3";
 
Wert

Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquelle.

 
Standardwert

Keiner.

formNN 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.

nameNN 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.myButton.name = "Win32";
 
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.

typeNN 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 == "button") {
    // process button 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

checkbox

valueNN 2 IE 3 DOM 1

Lesen/Schreiben

Dies ist einer der seltenen Fälle, in denen die Beschriftung eines Formularsteuerelements durch die Eigenschaft value festgelegt wird: der Text, der auf der Schaltfläche angezeigt wird. Der Input-Elementtyp button wird nicht mit dem Formular übermittelt.

 
Beispiel
 
document.forms[0].myButton.value = "Undo";
 
Wert

Zeichenfolge.

 
Standardwert

Keiner.

createTextRange( )NN nicht zutreffend IE 4(Win) DOM nicht zutreffend

Erstellt ein TextRange-Objekt, das den Beschriftungstext der Schaltfläche enthält. 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
 
  • Ein event-Objekt von Navigator 4.
 
Zurückgegebener Wert

Keiner.