blob: 535e81c0d710db868050bfb2809ad7b23a4e1251 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
---
title: Menus
slug: Archive/Mozilla/XUL/PopupGuide/Menus
tags:
- XUL
- XUL Popup Guide
translation_of: Archive/Mozilla/XUL/PopupGuide/Menus
---
<p>
<span id="Menus"></span>
</p>
<h3 id=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC" name=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC">メニュー</h3>
<p>メニューはユーザが実行できるコマンドの一覧を提供します。
</p><p><span id="Menu_Types"></span>
</p>
<h4 id=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E3.81.AE.E7.A8.AE.E9.A1.9E" name=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E3.81.AE.E7.A8.AE.E9.A1.9E">メニューの種類</h4>
<p>メニューは <code>menupopup</code> タグを使って作成します。メニューは一般にメニューバーかボタンに取り付けられます。メニューかボタンがクリックされるとメニューが開かれ、利用できるコマンドが一覧表示されます。ユーザはコマンドを選んで実行したり、 Esc キーを押すかメニューの外側をクリックする事で操作をキャンセルすることができます。
</p><p>XUL にはメニューを作成するためのタグがいくつか用意されています。それらのタグを使って、メニューをメニューバー上に設置したり、ボタンに取り付けることが出来ます。また、メニューをメニューの中に入れ子にすることによってサブメニューが作成できます。メニューやサブメニューを開いたり閉じたりするのに特別なコードを書く必要は無く、メニューはスクリーン上の適切な位置に自動的に設置されます。
</p><p>menupopup を取り付けられる要素には 4 種類のものがあります。どの場合でも、menupopup 要素はその要素の直接の子として設置します。以下にそれらの要素の概要を示します。それぞれの詳しい例は後ほどお見せします。
</p>
<dl><dt>menu
</dt><dd>menu タグはメニューバーにメニューを設置する時に使用します。アプリケーションウィンドウの上端 (またはスクリーン上部のメニューバー) にある「ファイル」や「編集」などがメニューの例です。この種類のメニューは普通、アプリケーション全体に対して適用するコマンドのために使われます。その時点で適用できないコマンドは無効にするべきですが、実際のトップレベルメニューはほとんどの場合ウィンドウによって変化することはありません。
</dd><dt>button
</dt><dd>ボタンの <code id="a-type"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/type">type</a></code> 属性を「menu」にすると、メニューをボタンに取り付けることが出来ます。こうすると、普通のボタンではなく小さな矢印やその他のインジケータの付いたボタンが作成されます。ボタンをクリックするとメニューが表示され、コマンドを選択できます。この種類のメニューは、一連のコマンドを提供したいけれどメニューバーを使いたくない場合、例えばダイアログボックスなどでよく使用されます。詳しくは<a href="ja/XUL/PopupGuide/MenuButtons">メニューボタン</a>を参照して下さい。
</dd><dt>toolbarbutton
</dt><dd>ツールバーボタンもメニューをサポートしています。これは他のボタンと同じように動作します。詳細は<a href="ja/XUL/PopupGuide/MenuButtons">メニューボタン</a>を参照して下さい。
</dd><dt>menulist
</dt><dd>menulist はユーザに一覧の中からアイテムを選択させたい時に使用します。この種類のメニューでは、その中のアイテムのうちの一つが選択されます。他のアイテムが選択されると、そのアイテムのラベルが menulist のラベルとして設定されます。他のユーザインターフェイスではこの種のウィジェットはコンボボックスと呼ばれています。
</dd></dl>
<p>menupopup タグの代わりに popup タグが使用されているのを見かける事があるかもしれません。 popup タグは非推奨ですが、menupopup タグと同等のものです。
</p><p><span id="Menu_Tag_Overview"></span>
</p>
<h4 id=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E7.94.A8.E3.82.BF.E3.82.B0.E3.81.AE.E6.A6.82.E8.A6.81" name=".E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E7.94.A8.E3.82.BF.E3.82.B0.E3.81.AE.E6.A6.82.E8.A6.81">メニュー用タグの概要</h4>
<p>以下は「File」というラベルの付けられたメニューを一つだけ持つ簡単なメニューバーの例です。
</p><p><img alt="Image:Popupguide-menubar.png">
</p>
<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>
</menubar>
</pre>
<p>この例では 5 つのタグが使われています。簡単に説明します。
</p>
<dl><dt>menubar
</dt><dd>ウィンドウまたはスクリーンの上端に表示されるメニューの列です。この中には menu 要素を格納するべきです。
</dd></dl>
<dl><dt>menu
</dt><dd>「File」や「Tools」などの、メニューバー上のメニューのラベルです。メニューはサブメニューのラベルとしても使用されます。
</dd></dl>
<dl><dt>menupopup
</dt><dd>メニュー上に表示されるアイテムを格納したポップアップです。上の例の menupopup は「File」メニューの子で、メニューのラベルがクリックされると表示されます。
</dd></dl>
<dl><dt>menuitem
</dt><dd>メニュー上に表示される個々のアイテムです。ユーザがマウスを menuitem の上に移動すると、アイテムがハイライトされます。カーソルキーを使っても選択中のアイテムを変更できます。 menuitem は実行するコマンドと関連付けられます。
</dd></dl>
<dl><dt>menuseparator
</dt><dd>メニューのアイテムの間の区切りです。
</dd></dl>
<p>上の例では、「File」メニューには 4 つの menuitem と 1 つの menuseparator があります。menu と menuitem はそれぞれその目的を表すラベルを持っています。
</p><p>他の種類のタグを menupopup 上に表示させる事は出来ません。メニューとは違う多目的のポップアップを作成したければ、panel を使用してください。詳しくは <a href="ja/XUL/PopupGuide/Panels">パネル</a> を参照して下さい。
</p><p><span id="The_menubar_element"></span>
</p>
<h5 id="menubar_.E8.A6.81.E7.B4.A0" name="menubar_.E8.A6.81.E7.B4.A0">menubar 要素</h5>
<p>メニューバーは XUL の menubar タグを使って作成します。通常は、メニューバーはアプリケーションのメインウィンドウの上部を横切るように配置されます。Macintosh では、メニューバーはスクリーンの上端に配置されます。この違いに対処するのに何か特別な事をする必要はありません。XUL ウィンドウがパースされる時、最初に見つかった menubar がそのウィンドウのメインメニューバーとして使用され、Macintosh ではそれがメインウィンドウから隠されてスクリーン上部のネイティブメニューに変換されます。このため、ウィンドウはメニューバーを 1 つだけ持つべきですが、それぞれのウィンドウが違うメニューバーを持つことは可能です。
</p><p>menubar の中には menu 要素をそれぞれのメニューに対して 1 つ置きます。下は 3 つのメニューを持つメニューバーの例です。
</p>
<pre><menubar id="sample-menubar">
<menu id="file-menu" label="File">
...
</menu>
<menu id="tools-menu" label="Tools">
...
</menu>
<menu id="help-menu" label="Help">
...
</menu>
</menubar>
</pre>
<p>menubar に他の要素を置く事も可能ですが、それらは Macintosh では表示されないという事を覚えておいてください。そのため、その要素の機能を他の場所で使用できないか確かめるべきです。もしくは、複数のプラットフォームで異なる方法をとるようなコードを書いてください。menubar に他の要素を設置する時に、それを他のメニューの隣ではなく反対側におきたい事があるかもしれません。これは伸び縮みする spacer を置く事で可能になります。
</p>
<pre><menubar id="sample-menubar">
<menu id="file-menu" label="File">
...
</menu>
<spacer flex="1"/>
<image src="logo.png"/>
</menubar>
</pre>
<p>この例では、ロゴ画像がメニューバーの端に設置されます。
</p><p><span id="The_menupopup_element"></span>
</p>
<h5 id="menupopup_.E8.A6.81.E7.B4.A0" name="menupopup_.E8.A6.81.E7.B4.A0">menupopup 要素</h5>
<p>menupopup 要素は、メニューアイテムを表示するポップアップです。menubar のメニューに対して使う時は、menupopup を menu 要素の子要素として設置します。以下は簡単なヘルプメニューの例です。
</p>
<pre><menu label="Help">
<menupopup>
<menuitem label="Contents"/>
<menuitem label="Search Help"/>
</menupopup>
</menu>
</pre>
<p>通常は、menupopup は隠されています。「Help」ラベルが押されると、menupopup がウィンドウの上端に、Help メニューのラベルの底辺に揃えて表示されます。メニューコマンドが選択されるかメニューがキャンセルされると、menupopup は再びスクリーンに表示されなくなります。
</p><p><span id="The_menu_element"></span>
</p>
<h5 id="menu_.E8.A6.81.E7.B4.A0" name="menu_.E8.A6.81.E7.B4.A0">menu 要素</h5>
<p>menu 要素は menubar 上のラベルやサブメニューのラベルに使われます。サブメニューについての情報は、下の<a href="ja/XUL/PopupGuide/Menus#Submenus">サブメニュー</a>を参照して下さい。
</p><p>menu 要素のラベルは <code id="a-label"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/label">label</a></code> 属性を使って指定します。下の例では、メニューに「View」というラベルが付けられています。
</p>
<pre><menu label="View">
<menupopup>
<menuitem label="Toolbar"/>
<menuitem label="Status Bar"/>
</menupopup>
</menu>
</pre>
<p>メニューがクリックされると、メニューはその中に格納された menupopup を開きます。このため、menupopup は menu の直接の子として設置するようにして下さい。
</p><p>メニューはキーボードを使っても開く事ができます。ユーザは特定のキーを押してメニューのラベルをハイライトさせて、カーソルキーを使ってメニュー間を移動します。このキーはプラットフォーム毎に異なり、例えば Windows では F10 キーが使われます。メニューコマンドに簡単にアクセスできるようにするもう一つの方法として、それぞれの menu 要素にアクセスキーと呼ばれるショートカットキーを追加する方法があります。いくつかのプラットフォームでは、アクセスキーを追加すると、どのキーを押せばいいのかを示すためにメニューのラベルの中の一文字に下線が引かれます。このため、アクセスキーは必ずメニューのラベルに表示される文字のどれかと一致させるべきです。
</p><p>メニューに対してアクセスキーを設定するには、下の例のように <code id="a-accesskey"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/accesskey">accesskey</a></code> 属性を使います。
</p>
<pre><menu label="File" accesskey="F"/>
</pre>
<p>このメニューは (一般的には Alt キーと同時に) アクセスキーを押すことで開く事が出来ます。
</p><p>当然のことながら、アクセスキーは menubar の中で一意のものであるべきです。よってもし「Find」というラベルのメニューを追加したければ、違うアクセスキーを設定する必要があるでしょう。
</p>
<pre><menubar>
<menu label="File" accesskey="F"/>
<menu label="Find" accesskey="d"/>
</menubar>
</pre>
<p>この例では、「File」メニューのアクセスキーが「F」に、「Find」メニューのアクセスキーが「d」に設定されています。アクセスキーは大文字と小文字を区別しませんが、大文字小文字が一致するものがあれば必ずそちらに下線が引かれます。例えば、アクセスキー「W」は「Window」というメニューラベルの最初の文字にマッチしますが、アクセスキー「w」は最後の文字にマッチします。アクセスキーを設定する時には常に大文字小文字を一致させた方がいいでしょう。
</p><p><span id="The_menuitem_element"></span>
</p>
<h5 id="menuitem_.E8.A6.81.E7.B4.A0" name="menuitem_.E8.A6.81.E7.B4.A0">menuitem 要素</h5>
<p>menuitem 要素はメニューのポップアップ上に現れる個々のアイテムに使われます。menu 要素と同様に、 <code id="a-label"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/label">label</a></code> 属性と <code id="a-accesskey"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/accesskey">accesskey</a></code> 属性を使ってアイテムに対してラベルとアクセスキーを設定できます。
</p>
<pre><menuitem label="Open" accesskey="O"/>
</pre>
<p><img alt="Image:Popupguide-menuaccesskey.png">
</p><p>menuitem のアクセスキーはそれが格納されているメニューが開かれている間しか機能しないので、アクセスキーはそのメニューの中でのみ一意のものであれば良いという事になります。
</p><p>メニューが開かれている間にアイテムがマウスでクリックされるかアクセスキーが押されると、menuitem で command イベントが発生します。これを利用して、menuitem に特定の動作を関連付ける事が出来ます。例えば「Open」メニューアイテムに、開くファイルを選択するためのファイルピッカーを開く動作を関連付けたり出来ます。この例では、 <code id="a-oncommand"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/oncommand">oncommand</a></code> 属性を使って command イベントリスナをアイテムに取り付けています。ここではただ単に警告メッセージを開くだけにしています。
</p>
<pre><menuitem label="Open" accesskey="O" oncommand="alert('Open a File!');"/>
</pre>
<p>メニューアイテムに動作を関連付けるには、 command 要素を使う方法もあります。下の例は先ほどの例と同じ効果がありますが、command イベントを直接とらえる代わりに command 要素を使っています。
</p>
<pre><command id="cmd_open" oncommand="alert('Open a File!');"/>
...
<menuitem label="Open" accesskey="O" command="cmd_open"/>
</pre>
<p><code id="a-command"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/command">command</a></code> 属性には同じドキュメント内にあるコマンド要素の id を設定します。この場合は「cmd_open」です。こうすると、command イベントは menuitem ではなく command 要素で発生します。これは例えばメニューバーのメニューアイテムや、コンテキストメニュー、ツールバーボタンなどのいくつかの要素に同じ動作を実行させたい時に便利です。それぞれの要素に command を結びつければ、実行するコードを command 要素に一度設置するだけで済むからです。
</p><p>menuitem には、ラベルの横にアイコンや関連付けられたショートカットを表示させる事も出来ます。メニューにショートカットキーを追加する方法の詳細は<a href="ja/XUL/PopupGuide/MenuItems#Adding_Shortcut_Keys_to_Menu_Items">メニューアイテムにショートカットキーを追加する</a>を参照して下さい。また、メニューにアイコンを追加する方法は<a href="ja/XUL/PopupGuide/MenuItems#Adding_Icons_to_Menu_Items">メニューアイテムにアイコンを追加する</a>を参照して下さい。
</p><p>チェックボックス型のメニューアイテムやラジオボタン型のメニューアイテムを作成する方法は <a href="ja/XUL/PopupGuide/MenuItems#Checkbox_Menu_Items">チェックボックス型メニューアイテム</a> もしくは <a href="ja/XUL/PopupGuide/MenuItems#Radio_Menu_Items">ラジオボタン型メニューアイテム</a>を参照して下さい。
</p><p>メニューアイテムは <code id="a-disabled"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/disabled">disabled</a></code> 属性を true にする事で無効にすることが出来ます。この例は<a href="ja/XUL/PopupGuide/MenuItems#Disabling_a_Menuitem">メニューアイテムの無効化</a>を参照して下さい。
</p><p><span id="The_menuseparator_element"></span>
</p>
<h5 id="menuseparator_.E8.A6.81.E7.B4.A0" name="menuseparator_.E8.A6.81.E7.B4.A0">menuseparator 要素</h5>
<p>menuseparator 要素を使うとメニューの間に区切りを作成する事が出来ます。メニューの中で関連性のあるコマンドは一つにまとめ、異なるグループの間には区切りを入れるのがいいでしょう。そうするとメニュー上のアイテムを見分けるのが簡単になります。menuseparator に使用できる特別な属性はありません。
</p>
<pre><menuseparator/>
</pre>
<p><span id="Submenus"></span>
</p>
<h4 id=".E3.82.B5.E3.83.96.E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC" name=".E3.82.B5.E3.83.96.E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC">サブメニュー</h4>
<p>メニュー上のアイテムに、それが選択された時にのみ開かれるもう一つのメニューにしまい込まれた追加のコマンドを持たせたい事があるでしょう。menu 要素を他の menupopup の中に入れ子にすると、サブメニューを作成できます。マウスがサブメニューのラベルの上に移動するか、カーソルキーでサブメニューを選択すると、そのメニューのポップアップが表示されます。マウスが離れるか選択アイテムが変更されると、メニューは閉じられます。
</p>
<pre><menubar id="sample-menubar">
<menu id="view-menu" label="View">
<menupopup>
<menuitem label="Toolbar"/>
<menuitem label="Status Bar"/>
<menuseparator/>
<menu label="Sort" accesskey="S">
<menupopup>
<menuitem label="By Name"/>
<menuitem label="By Date"/>
</menupopup>
</menu>
</menupopup>
</menu>
</menubar>
</pre>
<p><img alt="Image:Popupguide-submenus.png">
</p><p>この例では、トップレベルの「View」メニューが 2 つのメニューアイテムと、 1 つの区切り線と、menu タグで作成された 1 つのサブメニューを持っています。このメニューは「Sort」というラベルとアクセスキー「S」を持っています。また、このメニューは 2 つのアイテムを持つ menupopup を子に持っています。この menupopup の構文は外側の menupopup と同じものです。
</p><p>さらに、「Sort」menupopup の中のアイテムとしてもう一つ menu 要素を使用すれば、 3 段階目のメニューを追加する事も出来ます。ですが、そうするとユーザにとっての使用が難しいものになってしまいがちなので、あまり深いレベルのサブメニューは追加しない方がいいでしょう。
</p><p><span id="Sharing_Menus_Between_Windows"></span>
</p>
<h4 id=".E3.82.A6.E3.82.A3.E3.83.B3.E3.83.89.E3.82.A6.E9.96.93.E3.81.A7.E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E3.82.92.E5.85.B1.E6.9C.89.E3.81.99.E3.82.8B" name=".E3.82.A6.E3.82.A3.E3.83.B3.E3.83.89.E3.82.A6.E9.96.93.E3.81.A7.E3.83.A1.E3.83.8B.E3.83.A5.E3.83.BC.E3.82.92.E5.85.B1.E6.9C.89.E3.81.99.E3.82.8B">ウィンドウ間でメニューを共有する</h4>
<p>いくつかのウィンドウで同じメニューバーを共有したければ、メニューバーをオーバーレイに設置してそれを全てのウィンドウに適用するというのが一般的な手法です。こうするとコードが重複することなくそれぞれのウィンドウにメニューバーを共有させる事が出来ます。例えば、 Tools メニューを全てのウィンドウで共有させたければ、メニューをオーバーレイの中に作成し、それぞれのウィンドウには一行だけ書いてそのメニューを追加します。
</p>
<pre><menu id="menu-tools"/>
</pre>
<p>オーバーレイには、そのメニューの内容が完全に記述された、同じ「menu-tools」という id を持つ <code>menu</code> を設置してください。
</p><p>もしウィンドウ間でちょっとした違いを持たせたければ、load イベントリスナでメニューアイテムを表示したり隠したりするのもいいでしょう。例えば、ウィンドウが開かれる時にアイテムを非表示にしたければこのようにします。
</p>
<pre>function initMenus()
{
var item = document.getElementById("menu-file-open");
item.hidden = true;
}
</pre>
<p>「menu-fileOpen」という id を持つメニューを隠すために <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/hidden">hidden</a></span></code> プロパティが true に設定されています。この関数は window の <code id="a-onload"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/onload">onload</a></code> 属性の中で呼び出すことが出来ます。
</p>
<div class="noinclude">
</div>
|
