XUL:checkbox
出典: MDC
« XUL リファレンス HOME [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]
オンにしたりオフにすることができる要素です。ごく一般的に要素がオフの時に四角として描かれ、要素がオフの時にチェックされた四角に表示されます。ユーザはマウスで選択することでチェックボックスの状態を切替えられます。label 属性で指定された label はチェックボックスの隣に追加されます。
詳しい情報が XUL チュートリアルにあります。
- 属性
- accesskey, checked, command, crop, disabled, src, label, preference, tabindex
- プロパティ
- accessKey, accessibleType, checked, command, crop, disabled, src, label, tabIndex
<checkbox label="JavaScript を有効にする" checked="true"/>
<checkbox label="Java を有効にする" checked="false"/>
[編集] 属性
|
XUL 要素からの継承
align,
allowevents,
allownegativeassertions,
class,
coalesceduplicatearcs,
collapsed,
container,
containment,
context,
contextmenu,
datasources,
dir,
empty,
equalsize,
flags,
flex,
height,
hidden,
id,
insertafter,
insertbefore,
left,
maxheight,
maxwidth,
menu,
minheight,
minwidth,
mousethrough,
observes,
ordinal,
orient,
pack,
persist,
popup,
position,
preference-editable,
querytype,
ref,
removeelement,
sortDirection,
sortResource,
sortResource2,
statustext,
style,
template,
tooltip,
tooltiptext,
top,
uri,
wait-cursor,
width
|
- accesskey
- 型: character
- ショートカットキーとして使用される文字を設定します。この文字はその要素の
label 属性のテキストに現れる文字の一つでなければいけません。
- checked
- 型: boolean
- 要素にチェックが入っているかどうかを示します。
- この属性が設定されているかどうかを確認するには、
getAttribute() ではなく hasAttribute() を使用してください。
- command
- 型: 要素 id
- 要素に監視された command 要素の id をセットします。
- crop
- 型: 下記の値のいずれか一つ
- 要素の label に与えられた空間が小さ過ぎるときは、
crop 属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis) が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
-
start: テキストは先頭から切り取られます。
-
end: テキストは末尾から切り取られます。
-
left: 非推奨 テキストは左側から切り取られます。
-
right: 非推奨 テキストは右側から切り取られます。
-
center: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。
-
none: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment) に依存します。
- disabled
- 型: 真偽値
- 要素が無効化されているかどうかを示します。ある要素が
true に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command イベントも発生しません。
- src
- 型: 画像の URL
- チェックボックス内に表示する画像の URL を設定します。この属性が無いときは画像が表示されません。チェックボックスには画像とラベルの両方を設定することができます。
- label
- 型: string
- 要素上に表示するlabel。 省略された場合、テキストは表示されない。
- preference
- 型: 要素の id
- 要素を対応する preference につなぎます。この属性は prefwindow 内で使用された場合のみ効果があります。preference の値は、要素の value プロパティと一致するように更新されます。
- tabindex
- 型: 整数
- 要素のタブの順番。タブの順番は tab キーが押下されたときにフォーカスが移動する順番です。より大きな
tabindex の値をもつ要素は、タブの遷移が後になります。
[編集] プロパティ
|
XUL 要素からの継承
align,
allowEvents,
boxObject,
builder,
className,
collapsed,
contextMenu,
controllers,
currentItem,
database,
datasources,
dir,
flex,
height,
hidden,
id,
left,
listBoxObject,
maxHeight,
maxWidth,
menu,
minHeight,
minWidth,
observes,
ordinal,
orient,
pack,
persist,
ref,
resource,
statusText,
style,
tooltip,
tooltipText,
top,
value,
width
DOM 要素からの継承
attributes,
childNodes,
cloneNode,
firstChild,
lastChild,
localName,
namespaceURI,
nextSibling,
nodeName,
nodeType,
nodeValue,
ownerDocument,
parentNode,
prefix,
previousSibling,
tagName
|
- accessKey
- 型: character
- accesskey 属性の値の取得と設定。
- accessibleType
- 型: integer
- 要素の accessibility オブジェクトの種類を示す値。
- checked
- 型: boolean
- checked 属性の値の取得と設定。
- command
- 型: 要素の id
- command 属性の値の取得と設定。
- crop
- 型: string
- crop 属性の値の取得と設定。
- disabled
- 型: 真偽値
- disabled 属性の値の取得と設定。
- src
- 型: URL
- src 属性の値の取得と設定。
- label
- 型: string
- label 属性の値の取得と設定。
- tabIndex
- 型: 整数
- tabindex 属性の値の取得と設定。
[編集] メソッド
|
XUL 要素からの継承
blur,
click,
doCommand,
focus,
getElementsByAttribute
DOM 要素からの継承
addEventListener,
appendChild,
dispatchEvent,
getAttribute,
getAttributeNode,
getAttributeNodeNS,
getAttributeNS,
getElementsByTagName,
getElementsByTagNameNS,
hasAttribute,
hasAttributeNS,
hasAttributes,
hasChildNodes,
insertBefore,
isSupported,
normalize,
removeAttribute,
removeAttributeNode,
removeAttributeNS,
removeChild,
removeEventListener,
replaceChild,
setAttribute,
setAttributeNode,
setAttributeNodeNS,
setAttributeNS
|
[編集] 関連項目
- インタフェース
- nsIAccessibleProvider, nsIDOMXULCheckboxElement