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

Das radio-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut auf "radio" gesetzt ist. Miteinander verwandten radio-Objekten wird derselbe Name zugewiesen. Dies bedeutet, dass alle gleichnamigen radio-Objekte in einer Sammlung (Array) zusammengefasst werden. Daher muss auf einzelne Optionsschalter ggf. als Einträge in einem Array verwiesen werden. Das gesamte Array verfügt natürlich über eine length-Eigenschaft, die Sie bei Bedarf zum Durchsuchen aller radio-Objekte in der Gruppe verwenden können, um das aktivierte Objekt zu ermitteln und dessen Wert abzurufen:

var radioGrp = document.forms[0].myRadio;
for (var i = 0; i< radioGrp.length; i++) {
    if (radioGrp[i].checked) {
        alert("The value of the chosen button is " + radioGrp [i].value);
    }
} 
 

Die nachfolgend aufgeführten Eigenschaften und Methoden gelten für einzelne Optionsschalter.

 
HTML-Äquivalent
 
<input type="radio">
 
Objektmodellreferenz
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
Objektspezifische Eigenschaften
 
checkeddataFlddataSrcdefaultCheckedform
namestatustypevalue
 
Objektspezifische Methoden
 
handleEvent( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften
 
BehandlungsroutineNNIEDOM
onblur642
onclick342
onfocus642
onmousedown442
onmousemove642
onmouseout642
onmouseover642
onmouseup442
checkedNN 2 IE 3 DOM 1

Lesen/Schreiben

Bestimmt, ob der Optionsschalter ausgewählt ist oder durch den Benutzer oder ein Skript aktiviert wird. Es werden nur die Namens-/Wertpaare derjenigen radio-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.myRadio[0].checked) {
    //process first radio button
}
 
Wert

Boolescher Wert: true | false.

 
Standardwert

false

dataFldNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Wird in IE für die Datenbindung verwendet, um den Namen einer Remote-Datenquellenspalte dem Attribut value eines Optionsschalterelements zuzuweisen, das durch die im Objekt definierten Eigenschaften festgelegt wird. 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.myRadio[0].dataFld = "cableModem";
 
Wert

Von der Groß-/Kleinschreibung abhängige Zeichenfolge mit dem 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.myRadio[0].dataSrc = "DBSRC3";
 
Wert

Von der Groß-/Kleinschreibung abhängige Zeichenfolge mit dem Bezeichner der Datenquelle.

 
Standardwert

Keiner.

defaultCheckedNN 2 IE 3 DOM 1

Lesen/Schreiben

Legt fest, ob im Tag das checked-Attribut für das Element definiert ist. Sie können die aktuelle checked-Eigenschaft mit defaultChecked vergleichen, um festzustellen, ob sich der Zustand des Steuerelements seit dem Laden des Dokuments geändert hat. Eine Änderung dieser Eigenschaft beeinflusst nicht den aktuellen checked -Status.

 
Beispiel
 
var rBut = document.forms[0].myRadio[0];
if (rBut.checked != rBut.defaultChecked) {
    // process for changed state
}
 
Wert

Boolescher Wert: true | false.

 
Standardwert

Wird durch das HTML-Tag-Attribut festgelegt.

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

nameNN 2 IE 3 DOM 1

Lesen/Schreiben

Dies ist der dem Formularsteuerelement zugeordnete Bezeichner. Der Wert dieser Eigenschaft wird als eine Hälfte des Namens-/Wertpaares übertragen, wenn das Formular an den Server gesendet wird (die Eigenschaft value des markierten Optionsschalters ist der Wertteil des Paares). 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. Weisen Sie allen Optionsschaltern in einer Gruppe, deren Aktivieren/Deaktivieren-Eigenschaften miteinander verknüpft sind, denselben Namen zu. 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. Dennoch dürfen keine zwei Elemente denselben id-Attributwert aufweisen. Wenn Sie in Ihren Skripts die id der Elemente referenzieren müssen, sollten Sie daher für die gemeinsamen name-Attribute und die eindeutigen id-Attribute zwei separate Namensschemata verwenden.

 
Beispiel
 
document.orderForm.myRadio[0].name = "connectivity";
 
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.

statusNN 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].myRadio[0].status) {
    ...
}
 
Wert

Boolescher Wert: true | false.

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

radio

valueNN 2 IE 3 DOM 1

Lesen/Schreiben

Gibt den aktuellen Wert an, der mit dem Formularsteuerelement verknüpft ist, das im Namens-/Wertpaar für die Gruppe gleichnamiger Elemente übertragen wird (wenn der betreffende Optionsschalter 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].myRadio[0].value = "56kbps";
 
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
 
  • Ein event-Objekt von Navigator 4.
 
Zurückgegebener Wert

Keiner.