メニュー項目間の区切りの生成に使用されます。一般的には細い線が描画されます。
詳しい情報は XUL チュートリアルにあります。
- 属性
- acceltext, accesskey, allowevents, command, crop, disabled, image, label, selected, tabindex, value
- プロパティ
- accessibleType, accessKey, command, control, crop, disabled, image, label, labelElement, parentContainer, selected, tabIndex, value
例
<menu label="Menu"> <menupopup> <menuitem label="Item1"/> <menuseparator/> <menuitem label="Item2"/> <menuitem label="Item3"/> </menupopup> </menu>
属性
-
allowevents
- 型: 論理型
- true なら、イベントはその要素の子要素へ渡されます。そうでないなら、イベントはその要素のみに渡されます。
-
crop
- 型: 下記の値のいずれか一つ
- 要素の label に与えられた空間が小さ過ぎるときは、
crop
属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
start
: テキストは先頭から切り取られます。end
: テキストは末尾から切り取られます。left
: テキストは左側から切り取られます。right
: テキストは右側から切り取られます。center
: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。none
: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。
-
disabled
- 型: 論理型
-
要素が無効化されているかどうかを示します。ある要素が
true
に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command
イベントも発生しません。
-
label
- 型: 文字列型
- 要素上に表示するlabel。 省略された場合、テキストは表示されない。
selected
- 型: 論理型
- 要素が選択されているかどうかを返します。この値は読み取り専用です。選択された項目を変更するには
selectedIndex
かselectedItem
プロパティの値を変更してください。
-
tabindex
- 型: 整数型
- 要素のタブの順番。タブの順番は
tab
キーが押下されたときにフォーカスが移動する順番です。より大きなtabindex
の値をもつ要素は、タブの遷移が後になります。
-
value
- 型: 文字列型
- 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。
プロパティ
-
accessibleType
- 型: 整数型
- 要素の accessibility オブジェクトの種類を示す値。
-
labelElement
- 型:
label
要素 - control に関連付けられた
label
要素。これは label がこの要素を指し示すcontrol
属性を持つ場合に設定されます。このプロパティは、control に関連付けられた label が存在しない場合、null
になります。
-
parentContainer
- 型:
menu
要素 - 包含する
menu
要素を返す読み取り専用のプロパティです。包含する menu がない場合、null
を返します。
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