diff options
Diffstat (limited to 'files/ja/archive/mozilla/xul/menu/index.html')
| -rw-r--r-- | files/ja/archive/mozilla/xul/menu/index.html | 238 |
1 files changed, 238 insertions, 0 deletions
diff --git a/files/ja/archive/mozilla/xul/menu/index.html b/files/ja/archive/mozilla/xul/menu/index.html new file mode 100644 index 0000000000..b8464ed23f --- /dev/null +++ b/files/ja/archive/mozilla/xul/menu/index.html @@ -0,0 +1,238 @@ +--- +title: menu +slug: Archive/Mozilla/XUL/menu +tags: + - XUL Elements + - XUL Reference +translation_of: Archive/Mozilla/XUL/menu +--- +<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs"> + « <a href="/ja/docs/XUL/XUL_Reference">XUL リファレンス HOME</a> [ + <a href="#Examples">例</a> | + <a href="#Attributes">属性</a> | + <a href="#Properties">プロパティ</a> | + <a href="#Methods">メソッド</a> | + <a href="#Related">関連項目</a> ] +</span></div> +<p>この要素は、<code><code><a href="/ja/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code></code> 上に配置される <code><a href="/ja/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> のようなものです。 ユーザが <code><code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code></code> 要素をクリックすると、menu の子の <code><code><a href="/ja/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code></code> が表示されます。 この要素も、サブメニューを作るために使われます。</p> +<p>詳しい情報は <a href="/ja/XUL_Tutorial/Simple_Menu_Bars" title="ja/XUL_Tutorial/Simple_Menu_Bars">XUL チュートリアル</a>にあります。</p> +<dl><dt> 属性 </dt><dd> <a href="#a-acceltext">acceltext</a>, <a href="#a-accesskey">accesskey</a>, <a href="#a-allowevents">allowevents</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-menuactive">menuactive</a>, <a href="#a-open">open</a>, <a href="#a-sizetopopup">sizetopopup</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-value">value</a> </dd></dl> <dl><dt> プロパティ </dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-accessKey">accessKey</a>, <a href="#p-command">command</a>, <a href="#p-menuitem.control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-itemCount">itemCount</a>, <a href="#p-label">label</a>, <a href="#p-labelElement">labelElement</a>, <a href="#p-menupopup">menupopup</a>, <a href="#p-menu.open">open</a>, <a href="#p-parentContainer">parentContainer</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> </dd></dl> <dl><dt> メソッド </dt><dd> <a href="#m-appendItem">appendItem</a>, <a href="#m-getIndexOfItem">getIndexOfItem</a>, <a href="#m-getItemAtIndex">getItemAtIndex</a>, <a href="#m-insertItemAt">insertItemAt</a>, <a href="#m-removeItemAt">removeItemAt</a> </dd></dl> +<h3 id="Examples" name="Examples">例</h3> +<pre> <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> +</pre> +<h3 id="Attributes" name="Attributes">属性</h3> +<p> </p><div id="a-acceltext"> + +<dl> + <dt> + <code id="a-acceltext"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/acceltext">acceltext</a></code></dt> + <dd> + 型: <em>文字列型</em></dd> + <dd> + command を実行するためのショートカットキー (アクセラレータキー) を示す、<code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> ラベルのそばに表示されるテキスト。この値が設定されると、key 属性で割り当てられたキー設定が上書きされます。この属性は menubar 上のメニューには直接適用されません。</dd> +</dl> +</div> <div id="a-accesskey"> + + + + +<dl> + <dt><code id="a-accesskey"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/accesskey">accesskey</a></code></dt> + <dd>型: <em>文字型</em></dd> + <dd>ショートカットキーとして使用される文字を設定します。この文字はその要素の <code><code id="a-label"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/label">label</a></code></code> 属性のテキストに現れる文字の一つでなければいけません。 + + </dd> +</dl> + + +</div> <div id="a-allowevents"> + +<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/allowevents">allowevents</a></code> </dt><dd> 型: <em>論理型</em> </dd><dd> true なら、イベントはその要素の子要素へ渡されます。そうでないなら、イベントはその要素のみに渡されます。 </dd></dl> + + +</div> <div id="a-crop"> + + +<dl> + <dt><code id="a-crop"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/crop">crop</a></code></dt> + <dd>型: <em>下記の値のいずれか一つ</em></dd> + <dd>要素の label に与えられた空間が小さ過ぎるときは、<code>crop</code> 属性によって指定された側のテキストが切り取られます。テキストが切り取られた場所には省略記号 (ellipsis)が使用されます。ボックスの方向が反対の場合は、切り取られる場所も反対側になります。</dd> +</dl> + +<ul> + <li><code>start</code>: テキストは先頭から切り取られます。</li> + <li><code>end</code>: テキストは末尾から切り取られます。</li> + <li><code>left</code>: <span title="これは非推奨 API です。未だ動作しているかも知れませんが、将来的に削除される可能性があります。"><i class="icon-thumbs-down-alt"> </i></span> テキストは左側から切り取られます。</li> + <li><code>right</code>: <span title="これは非推奨 API です。未だ動作しているかも知れませんが、将来的に削除される可能性があります。"><i class="icon-thumbs-down-alt"> </i></span> テキストは右側から切り取られます。</li> + <li><code>center</code>: テキストの中央が切り取られ、通常、テキストの先頭と末尾が表示されます。</li> + <li><code>none</code>: テキストは省略記号を使用して切り取られません。しかし、テキストがあまりに長い場合は単純に削除されます。削除する側は CSS の行揃え (text alignment)に依存します。</li> +</ul> + + +</div> <div id="a-disabled"> + +<dl> + <dt> + <code id="a-disabled"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/disabled">disabled</a></code></dt> + <dd> + 型: <em>論理型</em></dd> + <dd> + 要素が無効化されているかどうかを示します。ある要素が <code>true</code> に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、<code>command</code> イベントも発生しません。 + + </dd> +</dl> + +<p> </p> +</div> <div id="a-label"> + +<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/label">label</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 要素上に表示するlabel。 省略された場合、テキストは表示されない。 </dd></dl> + + +</div> <div id="a-menuactive"> + +<dl><dt> <code id="a-menuactive"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/menuactive">menuactive</a></code> </dt><dd> 型: <em>論理型</em> </dd><dd> この属性は menu 内の項目がポイントされた時、その項目に設定されます。一般的に、この属性はテーマがメニュー項目を強調表示するために使用します。メニュー項目がポイントされた時、その項目には <code>DOMMenuItemActive</code> イベントが送られ、その選択が他へ移動した時、<code>DOMMenuItemInactive</code> イベントがその項目に送られます。 </dd></dl> + +</div> <div id="a-open"> + +<dl> + <dt><code id="a-open"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/open">open</a></code></dt> + <dd>型: <em>論理型</em></dd> + <dd><code>menu</code> の <code id="a-type"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/type">type</a></code> ボタンについて、メニューが開かれたとき、<code>open</code> 属性が <code>true</code> に設定されます。メニューが閉じられると <code>open</code> 属性は提供されません。</dd> +</dl> +</div> <div id="a-sizetopopup"> + +<dl><dt> <code id="a-sizetopopup"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/sizetopopup">sizetopopup</a></code> </dt><dd> 型: <em>下記の値のいずれか一つ</em> </dd><dd> menu の幅と <code><a href="/ja/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> の幅をどのように決定するかを指示します。<code>sizetopopup</code> 属性が設定されていないか、値に <code>none</code> が設定されている場合、menu が優先される幅になり、popup の幅は、この幅の外側まで拡張され、menu 自身の最大幅による影響を受けません。 </dd></dl> +<ul> <li><code>none</code>: popup の幅は menu のサイズにはなりません。</li> <li><code>always</code>: <code>always</code> に設定すると、menu の幅は <code><a href="/ja/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> に必要な幅と同じになります。menu に最大幅が設定されている場合、popup もその幅になります。</li> +</ul> + +</div> <div id="a-value"> + +<dl><dt> <code id="a-value"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/value">value</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 文字列の属性はデータ値を要素に関連付けます。特定の目的のために使われるわけではありませんが、スクリプトからあなた自身の用途のためにアクセスできます。 </dd></dl> + + +</div> +<h3 id="Properties" name="Properties">プロパティ</h3> +<p> </p><div id="p-accessibleType"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/accessibleType">accessibleType</a></span></code> </dt><dd> 型: <em>整数型</em> </dd><dd> 要素の accessibility オブジェクトの種類を示す値。 </dd></dl> + +</div> <div id="p-menuitem.control"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/menuitem.control">control</a></span></code> </dt><dd> 型: <em><code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> 要素</em> </dd><dd> 内部の item を囲む <code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> が存在するとき、それを返します。存在しないときは <code>null</code> を返します。 </dd></dl> +</div> <div id="p-itemCount"> +<dl> + <dt> + <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/itemCount">itemCount</a></span></code> </dt> + <dd> + 型: <em>整数型</em></dd> + <dd> + 子項目の数を保持する読み取り専用のプロパティ。</dd> +</dl> + + +</div> <div id="p-menupopup"> +<dl> + <dt> + <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/menupopup">menupopup</a></span></code></dt> + <dd> + 型: <em>menupopup 要素</em></dd> + <dd> + menu または menulist 要素で使用される <code><a href="/ja/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> への参照。このプロパティは読み取り専用です。</dd> +</dl> +<p> </p></div> <div id="p-menu.open"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/menu.open">open</a></span></code> </dt><dd> 型: <em>論理型</em> </dd><dd> menu が開いている場合、このプロパティは true に設定されます。menu は open プロパティを true に設定すると開かれ、false に設定すると閉じられます。 </dd></dl> +</div> <div id="p-parentContainer"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/parentContainer">parentContainer</a></span></code> </dt><dd> 型: <em><code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> 要素</em> </dd><dd> 包含する <code><a href="/ja/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> 要素を返す読み取り専用のプロパティです。包含する menu がない場合、<code>null</code> を返します。 </dd></dl> +</div> <div id="p-value"> +<dl> + <dt> + <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/value">value</a></span></code></dt> + <dd> + 型: <em>文字列型</em></dd> + <dd> + <code id="a-value"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/value">value</a></code> 属性の値の取得と設定。</dd> +</dl> +</div> +<h3 id="Methods" name="Methods">メソッド</h3> +<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238); float: right; width: 250px;"> +<tbody> +<tr> +<td> +<p><strong>XUL 要素からの継承</strong><br> +<small> <span id="m-blur"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getElementsByAttribute">getElementsByAttribute</a></code></span> <span id="m-getElementsByAttributeNS"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getElementsByAttributeNS">getElementsByAttributeNS</a></code></span></small></p> <p><strong>DOM 要素からの継承</strong><br> +<small> <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.appendChild">appendChild()</a></code>, <a href="/ja/DOM/Node.compareDocumentPosition" title="ja/DOM/Node.compareDocumentPosition">compareDocumentPosition</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <a href="/ja/DOM/Node.getFeature" title="ja/DOM/Node.getFeature">getFeature</a>, <a href="/ja/DOM/Node.getUserData" title="ja/DOM/Node.getUserData">getUserData</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.insertBefore">insertBefore()</a></code>, <a href="/ja/DOM/Node.isEqualNode" title="ja/DOM/Node.isEqualNode">isEqualNode</a>, <a href="/ja/DOM/Node.isSameNode" title="ja/DOM/Node.isSameNode">isSameNode</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.isSupported">isSupported()</a></code>, <a href="/ja/DOM/Node.lookupNamespaceURI" title="ja/DOM/Node.lookupNamespaceURI">lookupNamespaceURI</a>, <a href="/ja/DOM/Node.lookupPrefix" title="ja/DOM/Node.lookupPrefix">lookupPrefix</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code>, <a href="/ja/DOM/Node.setUserData" title="ja/DOM/Node.setUserData">setUserData</a></small></p> + +</td> +</tr> +</tbody> +</table> <div> + <span class="breadcrumbs XULRefMeth_breadcrumbs">« <a href="/ja/docs/XUL_Reference" title="/ja/docs/XUL_Reference">XUL リファレンス HOME</a></span></div> +<dl> + <dt> + <span id="m-appendItem"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/appendItem">appendItem(label,value )</a></code></span></dt> + <dd> + 戻り値の型: <em>要素</em></dd> + <dd> + 新しい項目を生成し、既存の項目リストの末尾に追加します。値の設定は任意です。この関数は新しく生成された要素を返します。</dd> +</dl> +<h2 id="Example" name="Example">例</h2> +<pre class="brush:html"><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></pre> +<h2 id="See_also" name="See_also">関連情報</h2> +<ul> + <li><a href="/ja/docs/XUL/Method/insertItemAt" title="XUL/Method/insertItemAt">insertItemAt()</a></li> + <li><a href="/ja/docs/XUL/Method/removeItemAt" title="XUL/Method/removeItemAt">removeItemAt()</a></li> +</ul> <dl> + <dt><span id="m-getIndexOfItem"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getIndexOfItem">getIndexOfItem( item )</a></code></span></dt> + <dd>戻り値の型: <em>整数型</em></dd> + <dd>指定した <var>item</var> の 0 を基点とした位置を返します。項目は、 list 内に表示された最初の項目から番号が付けられます。</dd> +</dl> <dl> + <dt><span id="m-getItemAtIndex"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getItemAtIndex">getItemAtIndex( index )</a></code></span></dt> + <dd>戻り値の型: <em>要素</em></dd> + <dd>指定した <var>index</var> の位置の要素を返します。</dd> +</dl> <dl> + <dt><span id="m-insertItemAt"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/insertItemAt">insertItemAt( index, label, value )</a></code></span></dt> + <dd>戻り値の型: <em>要素</em></dd> + <dd>このメソッドは新しい項目を生成し、それを指定した位置に挿入します。値の設定は任意です。新しい項目要素を返します。</dd> +</dl> <dl> + <dt><span id="m-removeItemAt"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/removeItemAt">removeItemAt( index )</a></code></span></dt> + <dd>戻り値の型: <em>要素</em></dd> + <dd>要素内の指定した index の子項目を削除します。このメソッドは削除した項目を返します。</dd> +</dl> +<h3 id="Related" name="Related">関連項目</h3> +<dl><dt> 要素 </dt><dd> <code><a href="/ja/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/ja/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/ja/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/ja/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/ja/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> </dd></dl> <dl><dt> インタフェース </dt><dd> <a href="/ja/nsIAccessibleProvider" title="ja/nsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="/ja/NsIDOMXULContainerElement" title="ja/NsIDOMXULContainerElement">nsIDOMXULContainerElement</a>, <a href="/ja/NsIDOMXULContainerItemElement" title="ja/NsIDOMXULContainerItemElement">nsIDOMXULContainerItemElement</a>, <a href="/ja/NsIDOMXULSelectControlItemElement" title="ja/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> </dd></dl> +<div class="noinclude"> + +</div> |