radio

オンまたはオフに切り替えられる要素です。radio ボタンはグループ化して使用されます。同じ radiogroup 内で一度に一つの radio ボタンのみを選択することができます。ユーザは、radio ボタンをマウスやキーボードで選択してオンに切り替えます。同じグループ内の他のボタンはオフになります。label 属性で指定されたラベルが radio ボタンの隣に追加されます。

詳しい情報は XUL チュートリアルをご覧ください。

属性
accesskey, command, crop, disabled, focused, group, image, label, selected, tabindex, value
プロパティ
accessKey, accessibleType, control, crop, disabled, image, label, radioGroup, selected, tabIndex, value

Image:XUL_ref_radio.png
<radiogroup>
  <radio id="orange" label="赤" accesskey="R"/>
  <radio id="violet" label="緑"  accesskey="G" selected="true"/>
  <radio id="yellow" label="青"  accesskey="B" disabled="true"/>
</radiogroup>

属性

accesskey
型: 文字型
ショートカットキーとして使用される文字を設定します。この文字はその要素の label 属性のテキストに現れる文字の一つでなければいけません。
command
型: 要素の id
要素に監視された command 要素の id をセットします。
crop
型: 下記の値のいずれか一つ
要素の label に与えられた空間が小さ過ぎるときは、crop 属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
  • start: テキストは先頭から切り取られます。
  • end: テキストは末尾から切り取られます。
  • left: テキストは左側から切り取られます。
  • right: テキストは右側から切り取られます。
  • center: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。
  • none: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。
disabled
型: 論理型
要素が無効化されているかどうかを示します。ある要素が true に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command イベントも発生しません。

 

focused
型: 論理型
要素がフォーカスされているとき、この属性値は true です。
group
型: グループ名の文字列
group 属性に同じ値を持つ、type="radio" のボタンは同じグループ内に置かれます。各グループでは一度に一つのボタンのみにチェックを入れることができます。ユーザが一つのボタンを選択すると、グループ内の他のボタンのチェックが外れます。
image
型: 画像の URL
要素上に表示する画像の URL。この属性が空または除外された場合、画像は表示されません。画像の位置は dir 属性および orient 属性によって決定されます。
label
型: 文字列型
要素上に表示するlabel。 省略された場合、テキストは表示されない。
selected
型: 論理型
要素が選択されているかどうかを返します。この値は読み取り専用です。選択された項目を変更するには selectedIndexselectedItem プロパティの値を変更してください。
tabindex
型: 整数型
要素のタブの順番。タブの順番は tab キーが押下されたときにフォーカスが移動する順番です。より大きな tabindex の値をもつ要素は、タブの遷移が後になります。
value
型: 文字列型
文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。

プロパティ

accessKey
型: 文字型
accesskey 属性の値の取得と設定。
accessibleType
型: 整数型
要素の accessibility オブジェクトの種類を示す値。
control
型: radiogroup 要素
radio 要素が内部に含む radiogroup を返します。これは radio 要素の直接の親要素であるとは限りません。
crop
型: 文字列型
crop 属性の値の取得と設定。
disabled
型: 論理型
disabled 属性の値の取得と設定。
image
型: image の URL
image 属性の値の取得と設定。
label
型: 文字列型
label 属性の値の取得と設定。
radioGroup
型: radiogroup 要素
control プロパティと同等。
selected
型: 論理型
このプロパティの値は、要素が選択されているときは true、選択されていないときは false です。このプロパティは読み取り専用です。
tabIndex
型: 整数型
tabindex 属性の値の取得と設定。
value
型: 文字列型
value 属性の値の取得と設定。

メソッド

関連項目

要素
radiogroup, checkbox
インタフェース
nsIAccessibleProvider, nsIDOMXULSelectControlItemElement, nsIDOMXULLabeledControlElement

添付ファイル

ファイル サイズ 日時 添付者:
XUL_ref_radio.png
1694 バイト 2007-12-26 14:48:06 Marsf
netscape-gecko-logo.jpg
42014 バイト 2005-12-26 15:36:15 Leandro Mercês Xavier

Document Tags and Contributors

Contributors to this page: Marsf
最終更新者: Marsf,