オンまたはオフに切り替えられる要素です。radio ボタンはグループ化して使用されます。同じ radiogroup
内で一度に一つの radio ボタンのみを選択することができます。ユーザは、radio ボタンをマウスやキーボードで選択してオンに切り替えます。同じグループ内の他のボタンはオフになります。label
属性で指定されたラベルが radio ボタンの隣に追加されます。
詳しい情報は XUL チュートリアルをご覧ください。
- プロパティ
- accessKey, accessibleType, control, crop, disabled, image, label, radioGroup, selected, tabIndex, value
例
<radiogroup> <radio id="orange" label="赤" accesskey="R"/> <radio id="violet" label="緑" accesskey="G" selected="true"/> <radio id="yellow" label="青" accesskey="B" disabled="true"/> </radiogroup>
属性
-
crop
- 型: 下記の値のいずれか一つ
- 要素の label に与えられた空間が小さ過ぎるときは、
crop
属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
start
: テキストは先頭から切り取られます。end
: テキストは末尾から切り取られます。left
: テキストは左側から切り取られます。right
: テキストは右側から切り取られます。center
: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。none
: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。
-
disabled
- 型: 論理型
-
要素が無効化されているかどうかを示します。ある要素が
true
に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command
イベントも発生しません。
-
focused
- 型: 論理型
- 要素がフォーカスされているとき、この属性値は
true
です。
group
- 型: グループ名の文字列
- group 属性に同じ値を持つ、type="radio" のボタンは同じグループ内に置かれます。各グループでは一度に一つのボタンのみにチェックを入れることができます。ユーザが一つのボタンを選択すると、グループ内の他のボタンのチェックが外れます。
-
label
- 型: 文字列型
- 要素上に表示するlabel。 省略された場合、テキストは表示されない。
selected
- 型: 論理型
- 要素が選択されているかどうかを返します。この値は読み取り専用です。選択された項目を変更するには
selectedIndex
かselectedItem
プロパティの値を変更してください。
-
tabindex
- 型: 整数型
- 要素のタブの順番。タブの順番は
tab
キーが押下されたときにフォーカスが移動する順番です。より大きなtabindex
の値をもつ要素は、タブの遷移が後になります。
-
value
- 型: 文字列型
- 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。
プロパティ
-
accessibleType
- 型: 整数型
- 要素の accessibility オブジェクトの種類を示す値。
-
control
- 型:
radiogroup
要素 -
radio
要素が内部に含むradiogroup
を返します。これは radio 要素の直接の親要素であるとは限りません。
-
radioGroup
- 型:
radiogroup
要素 -
control
プロパティと同等。
selected
- 型: 論理型
- このプロパティの値は、要素が選択されているときは
true
、選択されていないときはfalse
です。このプロパティは読み取り専用です。
メソッド
XUL 要素からの継承
blur
, click
, doCommand
, focus
, getElementsByAttribute
, getElementsByAttributeNS
DOM 要素からの継承
addEventListener()
, appendChild()
, compareDocumentPosition, dispatchEvent()
, getAttribute()
, getAttributeNode()
, getAttributeNodeNS()
, getAttributeNS()
, getElementsByTagName()
, getElementsByTagNameNS()
, getFeature, getUserData, hasAttribute()
, hasAttributeNS()
, hasAttributes()
, hasChildNodes()
, insertBefore()
, isEqualNode, isSameNode, isSupported()
, lookupNamespaceURI, lookupPrefix, normalize()
, removeAttribute()
, removeAttributeNode()
, removeAttributeNS()
, removeChild()
, removeEventListener()
, replaceChild()
, setAttribute()
, setAttributeNode()
, setAttributeNodeNS()
, setAttributeNS()
, setUserData
関連項目
- 要素
-
radiogroup
,checkbox