検索結果

menuitem

この記事内

« XUL リファレンス HOME [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]

menupopup 要素の中の一つです。これは button のように動作しますが、menu 上で動作します。

詳しい情報は XUL チュートリアルにあります。

属性: acceltext, accesskey, allowevents, autocheck, checked, closemenu, command, crop, description, disabled, image, key, label, name, selected, tabindex, type, validate, value

プロパティ: accessibleType, accessKey, command, control, crop, disabled, image, label, labelElement, parentContainer, selected, tabIndex, value

スタイルクラス: menuitem-iconic, menuitem-non-iconic

例



<menulist id="menulist">
  <menupopup id="menupopup">
    <menuitem label="firefox" />
    <menuitem label="thunderbird"/>
    <menuitem label="seamonkey"/>
    <menuitem label="mozilla"/>
  </menupopup>
</menulist>

属性

acceltext: 型: 文字列型; command を実行するためのショートカットキー (アクセラレータキー) を示す、menu ラベルのそばに表示されるテキスト。この値が設定されると、key 属性で割り当てられたキー設定が上書きされます。この属性は menubar 上のメニューには直接適用されません。

accesskey: 型: 文字型; ショートカットキーとして使用される文字を設定します。この文字はその要素の label 属性のテキストに現れる文字の一つでなければいけません。

allowevents: 型: 論理型; true なら、イベントはその要素の子要素へ渡されます。そうでないなら、イベントはその要素のみに渡されます。

autoCheck: 型: 論理型; この属性が true に設定されているか、この属性が無いとき、button が押下される度にボタンのチェック状態が切り替わります。false のときは、チェック状態を手動で調整しなければなりません。この属性が true の場合、button の種類は "checkbox" または "radio" でなければなりません。

{{ XULAttr("checked") }}: 型: 論理型; 要素にチェックが入っているかどうかを示します。; この属性が設定されているかどうかを確認するには、getAttribute() ではなく hasAttribute() を使用してください。

button 要素で、この属性による効果を得るには {{ XULAttr("type") }} 属性に checkbox か radio を設定しなければなりません。

Note: checked が true に設定されており、その値を persist 属性によって持続させる場合、menuitem にチェックが入っていないと、その値の持続に失敗します (バグ 15232)。これを回避するには autocheck を false に設定し、ユーザがアイテムを選択した時、属性を削除する代わりに、プログラムによって checked 属性を false に設定してください。(即ち、ユーザが menuitem のチェックを外した時、menuitem.removeAttribute("checked")) とするの代わりに menuitem.setAttribute("checked", "false") とします。false の値としてチェックマークが隠れ、その隠れた状態が持続されます。)

closemenu: 型: 下記の値のいずれか一つ; menuitem がアクティブになった時、menu を閉じるかどうかを示します。

auto: この値はデフォルトです。closemenu 属性が指定されていない場合、この menu と親メニューをすべて閉じます。
single: この属性が指定された menu の項目を閉じますが、親メニューは開いたままになります。
none: メニューは閉じられません。

command: 型: 要素の id; 要素に監視された command 要素の id をセットします。

crop: 型: 下記の値のいずれか一つ; 要素の label に与えられた空間が小さ過ぎるときは、crop 属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。

start: テキストは先頭から切り取られます。
end: テキストは末尾から切り取られます。
left: テキストは左側から切り取られます。
right: テキストは右側から切り取られます。
center: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。
none: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。

description: 型: 文字列型; dialog の title に加えて表示される説明的なテキスト。

disabled: 型: 論理型; 要素が無効化されているかどうかを示します。ある要素が true に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command イベントも発生しません。

image: 型: 画像の URL; 要素上に表示する画像の URL。この属性が空または除外された場合、画像は表示されません。画像の位置は dir 属性および orient 属性によって決定されます。

key: 型: 要素の id; key 要素の id を設定します。この要素が持つキーショートカットは menuitem 内に表示されます。

label: 型: 文字列型; 要素上に表示するlabel。省略された場合、テキストは表示されない。

name: 型: 文字列型の name; 同じ name を持つラジオ型 menuitem はグループ化されます。各ラジオグループ内で同時に一つの menuitem のみにチェックが入ります。

selected: 型: 論理型; 要素が選択されているかどうかを返します。この値は読み取り専用です。選択された項目を変更するには selectedIndex か selectedItem プロパティの値を変更してください。

tabindex: 型: 整数型; 要素のタブの順番。タブの順番は tab キーが押下されたときにフォーカスが移動する順番です。より大きな tabindex の値をもつ要素は、タブの遷移が後になります。

type: 型: 下記のいずれか一つ; チェック可能な menuitem の生成や、ラジオボタン型 menuitem のために使用されます。

checkbox: menuitem にチェックが入ります。checked 属性は menuitem にチェックが入っているかどうかを決定します。
radio: menuitem がラジオグループの一部になります。name 属性に同じ値を持つ他の menuitem は同じ radio グループの一部になります。同じグループ内で、同時に一つの menuitem のみにチェックを入れることができます。

メニューにチェックマークを追加するための詳しい情報は、XUL チュートリアルを参照してください。

validate: 型: 下記の値のいずれか一つ; この属性は、キャッシュから image を読み込むかどうかを指示します。image がリモートに格納されるときや、image を頻繁に差し替えようとしているとき、役立つでしょう。次の値はデフォルトで扱われる属性全体を許可、または除外します:

always: image を読み込むべきかどうか、常に確認されます。
never: 可能であれば、キャッシュから image が読み込まれます。

value: 型: 文字列型; 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。

プロパティ

accessibleType: 型: 整数型; 要素の accessibility オブジェクトの種類を示す値。

accessKey: 型: 文字型; accesskey 属性の値の取得と設定。

command: 型: 要素の id; command 属性の値の取得と設定。

control: 型: menu 要素; 内部の item を囲む menu が存在するとき、それを返します。存在しないときは null を返します。

crop: 型: 文字列型; crop 属性の値の取得と設定。

disabled: 型: 論理型; disabled 属性の値の取得と設定。

image: 型: image の URL; image 属性の値の取得と設定。

label: 型: 文字列型; label 属性の値の取得と設定。

labelElement: 型: label 要素; control に関連付けられた label 要素。これは label がこの要素を指し示す control 属性を持つ場合に設定されます。このプロパティは、control に関連付けられた label が存在しない場合、null になります。