この要素は、
上に配置される menubar
button
のようなものです。 ユーザが
要素をクリックすると、menu の子の menu
が表示されます。 この要素も、サブメニューを作るために使われます。menupopup
詳しい情報は XUL チュートリアルにあります。
- 属性
- acceltext, accesskey, allowevents, command, crop, disabled, image, label, menuactive, open, sizetopopup, tabindex, value
- プロパティ
- accessibleType, accessKey, command, control, crop, disabled, image, itemCount, label, labelElement, menupopup, open, parentContainer, selected, tabIndex, value
例
<menubar id="sample-menubar"> <menu id="file-menu" label="File"> <menupopup id="file-popup"> <menuitem label="New"/> <menuitem label="Open"/> <menuitem label="Save"/> <menuseparator/> <menuitem label="Exit"/> </menupopup> </menu> <menu id="edit-menu" label="Edit"> <menupopup id="edit-popup"> <menuitem label="Undo"/> <menuitem label="Redo"/> </menupopup> </menu> </menubar>
属性
-
allowevents
- 型: 論理型
- true なら、イベントはその要素の子要素へ渡されます。そうでないなら、イベントはその要素のみに渡されます。
-
crop
- 型: 下記の値のいずれか一つ
- 要素の label に与えられた空間が小さ過ぎるときは、
crop
属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
start
: テキストは先頭から切り取られます。end
: テキストは末尾から切り取られます。left
: テキストは左側から切り取られます。right
: テキストは右側から切り取られます。center
: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。none
: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。
-
disabled
- 型: 論理型
-
要素が無効化されているかどうかを示します。ある要素が
true
に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command
イベントも発生しません。
-
label
- 型: 文字列型
- 要素上に表示するlabel。 省略された場合、テキストは表示されない。
-
sizetopopup
- 型: 下記の値のいずれか一つ
- menu の幅と
menupopup
の幅をどのように決定するかを指示します。sizetopopup
属性が設定されていないか、値にnone
が設定されている場合、menu が優先される幅になり、popup の幅は、この幅の外側まで拡張され、menu 自身の最大幅による影響を受けません。
none
: popup の幅は menu のサイズにはなりません。always
:always
に設定すると、menu の幅はmenupopup
に必要な幅と同じになります。menu に最大幅が設定されている場合、popup もその幅になります。
-
value
- 型: 文字列型
- 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。
プロパティ
-
accessibleType
- 型: 整数型
- 要素の accessibility オブジェクトの種類を示す値。
-
itemCount
- 型: 整数型
- 子項目の数を保持する読み取り専用のプロパティ。
-
parentContainer
- 型:
menu
要素 - 包含する
menu
要素を返す読み取り専用のプロパティです。包含する menu がない場合、null
を返します。
メソッド
-
appendItem(label,value )
- 戻り値の型: 要素
- 新しい項目を生成し、既存の項目リストの末尾に追加します。値の設定は任意です。この関数は新しく生成された要素を返します。
例
<script> function addItemsToList() { var list = document.getElementById('myMenuList'); // add item with just the label list.appendItem('One'); // add item with label and value list.appendItem('Two', 999); // Select the first item list.selectedIndex = 0; } </script> <button label="Add items" oncommand="addItemsToList()" /> <menulist id="myMenuList"> <menupopup /> </menulist>
関連情報
getIndexOfItem( item )
- 戻り値の型: 整数型
- 指定した item の 0 を基点とした位置を返します。項目は、 list 内に表示された最初の項目から番号が付けられます。
getItemAtIndex( index )
- 戻り値の型: 要素
- 指定した index の位置の要素を返します。
insertItemAt( index, label, value )
- 戻り値の型: 要素
- このメソッドは新しい項目を生成し、それを指定した位置に挿入します。値の設定は任意です。新しい項目要素を返します。
removeItemAt( index )
- 戻り値の型: 要素
- 要素内の指定した index の子項目を削除します。このメソッドは削除した項目を返します。
関連項目
- インタフェース
- nsIAccessibleProvider, nsIDOMXULContainerElement, nsIDOMXULContainerItemElement, nsIDOMXULSelectControlItemElement