XUL:menu
出典: MDC
« XUL リファレンス HOME [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]
この要素は、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>
[編集] 属性
|
XUL 要素からの継承 |
- acceltext
- 型: string
- command を実行するためのショートカットキー (アクセラレータキー) を示す、menu ラベルのそばに表示されるテキスト。この値が設定されると、key 属性で割り当てられたキー設定が上書きされます。この属性は menubar 上のメニューには直接適用されません。
- allowevents
- 型: boolean
- true なら、イベントはその要素の子要素へ渡されます。そうでないなら、イベントはその要素のみに渡されます。
- crop
- 型: 下記の値のいずれか一つ
- 要素の label に与えられた空間が小さ過ぎるときは、
crop属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis) が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。
-
start: テキストは先頭から切り取られます。 -
end: テキストは末尾から切り取られます。 -
left: 非推奨 テキストは左側から切り取られます。 -
right: 非推奨 テキストは右側から切り取られます。 -
center: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。 -
none: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment) に依存します。
- disabled
- 型: 真偽値
- 要素が無効化されているかどうかを示します。ある要素が
trueに設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、commandイベントも発生しません。
- label
- 型: string
- 要素上に表示するlabel。 省略された場合、テキストは表示されない。
- menuactive
- 型: boolean
- この属性は menu 内の項目がポイントされた時、その項目に設定されます。一般的に、この属性はテーマがメニュー項目を強調表示するために使用します。メニュー項目がポイントされた時、その項目には
DOMMenuItemActiveイベントが送られ、その選択が他へ移動した時、DOMMenuItemInactiveイベントがその項目に送られます。
- sizetopopup
- 型: 下記の値のいずれか一つ
- menu の幅と menupopup の幅をどのように決定するかを指示します。
sizetopopup属性が設定されていないか、値にnoneが設定されている場合、menu が優先される幅になり、popup の幅は、この幅の外側まで拡張され、menu 自身の最大幅による影響を受けません。
-
none: popup の幅は menu のサイズにはなりません。 -
always:alwaysに設定すると、menu の幅は menupopup に必要な幅と同じになります。menu に最大幅が設定されている場合、popup もその幅になります。
- value
- 型: 文字列
- 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。
[編集] プロパティ
|
XUL 要素からの継承 DOM 要素からの継承 |
- accessibleType
- 型: integer
- 要素の accessibility オブジェクトの種類を示す値。
- control
- 型: menu 要素
- 内部の item を囲む menu が存在するとき、それを返します。存在しないときは
nullを返します。
- open Firefox 3 の新機能
- 型: boolean
- menu が開いている場合、このプロパティは true に設定されます。menu は open プロパティを true に設定すると開かれ、false に設定すると閉じられます。
- parentContainer Firefox 3 の新機能
- 型: menu 要素
- 包含する menu 要素を返す読み取り専用のプロパティです。包含する menu がない場合、
nullを返します。
[編集] メソッド
- appendItem( label, value )
- 戻り値の型: 要素
- 新しい項目を生成し、既存の項目リストの末尾に追加します。値の設定は任意です。この関数は新しく生成された要素を返します。
- getIndexOfItem( item )
- 戻り値の型: integer
- 指定した item の 0 を基点とした位置を返します。項目は、list 内に表示された最初の項目から番号が付けられます。
- getItemAtIndex( index )
- 戻り値の型: element
- 指定した index の位置の要素を返します。
- insertItemAt( index, label, value )
- 戻り値の型: element
- このメソッドは新しい項目を生成し、それを指定した位置に挿入します。値の設定は任意です。新しい項目要素を返します。
- removeItemAt( index )
- 戻り値の型: element
- 要素内の指定した index の子項目を削除します。このメソッドは削除した項目を返します。