input (type="checkbox") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||||||
Das checkbox-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut auf "checkbox" gesetzt wurde. Verwenden Sie dieses Element nicht als Navigationsschaltfläche, sondern nur als Benutzeroberflächenelement für die Optionsauswahl (ein-aus). Bei IE für Windows ab Version 5 und Netscape 6 können Sie die Größe des Kontrollkästchens über die Höhen- und Breitenattribute des Stylesheets anpassen, doch nur Netscape 6 skaliert auch das im Kontrollkästchen dargestellte Häkchen automatisch auf die optimale Größe und behält die korrekte Ausrichtung des dazugehörigen Texts am unteren Rand des Kontrollkästchens bei. |
||||||||||||||||||||||||||||||||||||
HTML-Äquivalent | ||||||||||||||||||||||||||||||||||||
<input type="checkbox"> |
||||||||||||||||||||||||||||||||||||
Objektmodellreferenz | ||||||||||||||||||||||||||||||||||||
[window.]document.formName.elementName [window.]document.forms[i].elements[i] [window.]document.getElementById("elementID") |
||||||||||||||||||||||||||||||||||||
Objektspezifische Eigenschaften | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Objektspezifische Methoden | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||||||||||||||||||||||||||||||||||||
|
checked | NN 2 IE 3 DOM 1 |
Lesen/Schreiben | |
Legt fest, ob das Kontrollkästchen aktiviert ist oder durch den Benutzer (oder ein Skript) aktiviert wird. Kontrollkästchen operieren unabhängig voneinander. Es werden nur die Namens-/Wertpaare derjenigen checkbox-Objekte mit dem Formular gesendet, deren checked-Eigenschaft auf true gesetzt ist. Informationen, wie Sie herausfinden können, ob das Formularelement aktiviert ist, wenn die Seite geladen wird, finden Sie unter der defaultChecked-Eigenschaft. In einem Skript kann diese Eigenschaft auch dann geändert werden, wenn das Element deaktiviert ist. |
|
Beispiel | |
if (document.choiceForm.monitors.checked) { //process for the "monitors" checkbox being checked } |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
false |
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 dem value-Attribut eines checkbox-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.myCheckbox.dataFld = "homeAddrFlag"; |
|
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.myCheckbox.dataSrc = "DBSRC3"; |
|
Wert | |
Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquelle. |
|
Standardwert | |
Keiner. |
defaultChecked | NN 2 IE 3 DOM 1 |
Lesen/Schreiben | |
Legt fest, ob das checked-Attribut im Tag für das Element gesetzt ist. Sie können die aktuelle checked-Eigenschaft mit defaultChecked vergleichen, um festzustellen, ob sich der Zustand des Steuerelements nach dem Laden des Dokuments geändert hat. Eine Änderung dieser Eigenschaft beeinflusst nicht den aktuellen checked-Status. |
|
Beispiel | |
var cBox = document.forms[0].checkbox1 if (cBox.checked != cBox.defaultChecked) { // process for changed state } |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
Wird durch das HTML-Tag-Attribut festgelegt. |
form | NN 2 IE 3 DOM 1 |
Schreibgeschützt | |
Gibt eine Referenz auf das form-Element zurück, in dem das aktuelle Element (sofern vorhanden) enthalten ist. 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. |
indeterminate | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt an, ob ein Kontrollkästchen weder als aktiviert noch als deaktiviert dargestellt wird, jedoch noch aktiviert ist. Der mittlere Zustand wird auf verschiedenen Betriebssystemen unterschiedlich dargestellt. Unter Windows erscheint das Kontrollkästchen abgeblendet (mit dem Kreuz sichtbar, wenn dies der ursprüngliche Zustand war) und noch aktiviert. Auf dem Macintosh wird das Kontrollkästchen mit einem Strich im Feld angezeigt. Dieser unbestimmte Zustand bedeutet in der Regel eine Änderung auf der Seite, die wahrscheinlich die Einstellung des Kontrollkästchens beeinflusst hat. Zur Genauigkeit ist ein Eingriff durch den Benutzer erforderlich, um die Einstellung des Kontrollkästchens zu überprüfen. Ein Kontrollkästchen im unbestimmten Zustand wird zusammen mit dem Formular übermittelt. |
|
Beispiel | |
document.orderForm.2DayAir.indeterminate = true; |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
false |
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.myCheckbox.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. |
status | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Legt fest, ob das Element hervorgehoben/aktiviert ist. Diese Eigenschaft ist identisch mit der checked-Eigenschaft. |
|
Beispiel | |
if (document.forms[0].56KbpsBox.status) { ... } |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
Keiner. |
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 == "checkbox") { // process checkbox 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 |
value | NN 2 IE 3 DOM 1 |
Lesen/Schreiben | |
Stellt den aktuellen Wert bereit, der dem Formularsteuerelement zugeordnet ist, das mit dem Namens-/Wertpaar des Elements gesendet wird (wenn das Kontrollkästchen aktiviert ist). Alle Werte sind Zeichenfolgen, können aber auch andere Arten von Daten darstellen, z. B. Boolesche und numerische Werte. |
|
Beispiel | |
document.forms[0].extraPhone.value = "cellPhone"; |
|
Wert | |
Zeichenfolge. |
|
Standardwert | |
Keiner. |
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. |