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

radio オブジェクトは、type 属性が "radio" に設定されている input 要素で作成されるフォームコントロールです。互いに関連し合う radio オブジェクトには同じ名前が付けられます。つまり、同じ名前が付いたすべての radio オブジェクトは radio オブジェクトのコレクション (配列) になります。したがって場合によっては、個々のラジオボタンを配列内のアイテムとして参照する必要があります。length プロパティは配列全体のプロパティです。必要に応じてこのプロパティを使用して、グループ内のすべての radio オブジェクトに対してループを実行し、どのオブジェクトが選択されているかを調べたり、オブジェクトの値を取得したりできます。

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);
    }
} 
 

次に示すプロパティやメソッドは個々のラジオボタンのものです。

 
相当する HTML コード
 
<input type="radio">
 
オブジェクト参照
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
オブジェクト固有のプロパティ
 
checkeddataFlddataSrcdefaultCheckedform
namestatustypevalue
 
オブジェクト固有のメソッド
 
handleEvent()
 
オブジェクト固有のイベントハンドラープロパティ
 
ハンドラーNNIEDOM
onblur642
onclick342
onfocus642
onmousedown442
onmousemove642
onmouseout642
onmouseover642
onmouseup442
checkedNN 2 IE 3 DOM 1

読み書き

ラジオボタンがユーザーまたはスクリプトによって選択されているかどうかを示します。checked プロパティが true に設定されている radio オブジェクトについてのみ、「名前/値」のペアがフォームと共に送信されます。ページの読み込み時にフォーム要素が checked に設定されているか調べる方法については、defaultChecked プロパティを参照してください。このプロパティは、要素が無効化されている場合も、スクリプトで変更が可能です。

 
 
if (document.choiceForm.myRadio[0].checked) {
    //process first radio button
}
 

true または false のブール値

 
既定値

false

dataFldNN なし IE 4 DOM なし

読み書き

IE のデータバインディングと共に使用して、リモートデータソースの列名を、オブジェクトのプロパティにより決定されるラジオボタン要素の value 属性に関連付けます。この要素には datasrc 属性も設定する必要があります。dataFlddataSrc の両方のプロパティに空の文字列を設定すると、要素とデータソースのバインディングが壊れます。Macintosh 版 IE 5 ではテキストファイルのデータソースに対してのみ機能します。

 
 
document.myForm.myRadio[0].dataFld = "cableModem";
 

データソース列の識別子を示す文字列。大文字と小文字は区別されます。

 
既定値

なし

dataSrcNN なし IE 4 DOM なし

読み書き

IE のデータバインディングと共に使用して、リモートデータアクセス用にデータソースオブジェクトを読み込むページの object 要素の ID を示します。データソースからのコンテンツは datafld 属性によって設定されます。dataFlddataSrc の両方のプロパティに空の文字列を設定すると、要素とデータソースのバインディングが壊れます。Macintosh 版 IE 5 ではテキストファイルのデータソースに対してのみ機能します。

 
 
document.myForm.myRadio[0].dataSrc = "DBSRC3";
 

データソースの識別子を示す文字列。大文字と小文字は区別されます。

 
既定値

なし

defaultCheckedNN 2 IE 3 DOM 1

読み書き

この要素の checked 属性がタグ内に設定されているかどうかを示します。現在の checked プロパティと defaultChecked とを比較して、ドキュメントが読み込まれた後でコントロールのステートが変わったかどうかを調べることができます。このプロパティを変更しても、現在の checked ステータスには影響がありません。

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

true または false のブール値

 
既定値

HTML タグの属性によって異なります。

formNN 2 IE 3 DOM 1

読み取り専用

現在の要素が入っている form 要素への参照を返します。この要素からイベントを処理する場合は、イベントハンドラー関数がイベントオブジェクトの target または srcElement プロパティとして input 要素に自動的にアクセスします。form プロパティを読み取ることにより、スクリプトで同じフォーム内の他のコントロールに簡単にアクセスできるようになります。

 
 
var theForm = evt.srcElement.form;
 

form 要素オブジェクトへの参照

 
既定値

なし

nameNN 2 IE 3 DOM 1

読み書き

フォームコントロールに関連付けられた識別子です。このプロパティの値は、フォームがサーバーに送信されるときに「名前/値」のペアの一部として送信されます (ハイライトされたラジオボタンの value プロパティが「値」の部分になります)。コントロールのラベルはコントロールタイプ別に他の方法で設定されるため、名前はユーザーには表示されません。フォームコントロールの名前は、オブジェクトへのスクリプト参照でも使用できます。ハイライト/ハイライトなしの特徴が関連する同じグループ内のラジオボタンには同じ名前を付けます。最近の規格では id 属性の方が推奨されていますが、多くのブラウザでは現在も、コントロールの値を送信するために、フォームコントロールに name 属性を設定する必要があります。ただし、2 つの要素間で id 属性に同じ値を使用することはできません。したがって、スクリプトで id を使用して要素を参照する場合は、共通の name 属性と固有の id 属性のそれぞれに対して別々の命名規則を検討してください。

 
 
document.orderForm.myRadio[0].name = "connectivity";
 

識別子の命名規則に従った文字列。大文字と小文字は区別されます。識別子には空白スペースは使用できず、1 文字目に数字は使用できません。アンダースコア以外の句読点の使用は避けてください。

 
既定値

なし

statusNN なし IE 4 DOM なし

読み書き

要素をハイライト表示する (つまり checked の状態で表示する) かどうかを示します。このプロパティは checked プロパティと同じです。

 
 
if (document.forms[0].myRadio[0].status) {
    ...
}
 

true または false のブール値

 
既定値

なし

typeNN 3 IE 4 DOM 1

読み取り専用

フォームコントロール要素のタイプを返します。値はすべて小文字で返されます。行う処理によっては、特定のタイプを検索するためにすべてのフォーム要素を調べる必要があります。たとえば、"text" タイプのフォームコントロールをすべてクリアにし、他のタイプのコントロールはそのままにする場合などがこれに該当します。

 
 
if (document.forms[0].elements[3].type == "radio") {
    // process radio input type here
}
 

buttoncheckboxfilehiddenimagepasswordradioresetselect-multipleselect-onesubmittexttextarea のいずれかの定数を示す文字列

 
既定値

radio

valueNN 2 IE 3 DOM 1

読み書き

同じ名前の要素グループの「名前/値」のペアとして送信される、フォームコントロールに関連付けられている現在の値を示します (特定のラジオボタンが選択されている場合)。値はすべて文字列ですが、ブール値や数値など他のタイプのデータを示す場合もあります。

 
 
document.forms[0].myRadio[0].value = "56kbps";
 

文字列

 
既定値

なし

handleEvent[]NN |4| IE なし DOM なし

handleEvent(event)

メソッドへのパラメータとして指定されたイベントを受け入れ、処理するようにオブジェクトに指示します。指定のイベントを処理するには、オブジェクトが適切なタイプのイベントハンドラーを持っている必要があります。Navigator 4 にのみ実装されています。

 
パラメータ
 
  • Navigator 4 で有効な event オブジェクト
 
戻り値

なし