blob: 323bf347671989ecf107be6e218742ed5a1c24d9 (
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
|
---
title: PopupGuide
slug: Archive/Mozilla/XUL/PopupGuide
tags:
- XUL
- XUL Popup Guide
translation_of: Archive/Mozilla/XUL/PopupGuide
---
<h2 id="Popups_and_Menus" name="Popups_and_Menus">ポップアップとメニュー</h2>
<p>作成できるポップアップの種類には様々なものがあります。ポップアップとは、メニュー、もしくは、タイトルバーやボーダーなどのメインウィンドウの外郭を拡張する装飾のないフローティングウィンドウの事です。</p>
<h3 id="Popup_Types" name="Popup_Types">ポップアップの種類</h3>
<p>XUL では、ポップアップメニューや他の種類のポップアップウィジェットを作成するのに、要素に取り付けられる方法や開かれる方法によって異なる様々な種類の要素が利用できます。ここではそれぞれの種類の概要を紹介します。詳細はリンク先を参照して下さい。</p>
<p>このガイドでは、「ポップアップ」という用語は全ての種類のポップアップを指すのに対して、「メニュー」という用語はポップアップの特定の種類を指します。具体的には、下の一覧の初めの 2 種類がメニューです。</p>
<dl>
<dt><a href="/ja/docs/XUL/PopupGuide/Menus">メニュー</a></dt>
<dd>メニューは、ユーザによって実行される一連のコマンドがあり、それぞれのコマンドに対してボタンを設置するスペースを使いたくない時に使用されます。メニューは普段は隠されており、選択されるとコマンドの一覧が格納されたポップアップが現れます。ユーザがコマンドを選択すると、メニューは再び見えなくなります。</dd>
<dd>メニューは <code>menupopup</code> 要素を使って作成します。 <code>menupopup</code> 要素はアイテムを一覧で表示し、サブメニューを表示でき、アイテム間でのキーボードによるナビゲーションを可能にします。メニューにはメニューに関係する要素しか格納してはいけません。</dd>
<dt><a href="/ja/docs/XUL/PopupGuide/ContextMenus">コンテキストメニュー</a></dt>
<dd>コンテキストメニューは普通のメニューに似ていますが、ユーザがコンテキストメニューを開く時にクリックした対象に対して、格納されたコマンドが適用されるという点で異なります。大抵は、クリックされた要素に対して適用できないようなコマンドは隠されます。</dd>
<dt><a href="/ja/docs/XUL/PopupGuide/Panels">パネル</a></dt>
<dd>パネルにはどんな内容でも格納する事ができます。パネルは既存の UI の上に一時的に何らかのコントロールを表示したい時に便利です。例えば、検索用のフィールドをポップアップで表示して、検索語句が入力されたらポップアップを消すといった事ができます。</dd>
<dd>パネルは <code>panel</code> 要素を使って作成します。</dd>
<dt><a href="/ja/docs/XUL/PopupGuide/Tooltips">ツールチップ</a></dt>
<dd>マウスがある UI コントロールの上に置かれると、ツールチップはそのコントロールについて説明するヘルプが書かれた小さなボックスを表示します。マウスがそのコントロールから離れると、ツールチップは自動的に消えます。</dd>
<dd>ツールチップは、要素に <code>tooltiptext</code> 属性を設定するか、 <code>tooltip</code> 要素を使う事によって作成できます。</dd>
</dl>
<h3 id="Working_with_Popups" name="Working_with_Popups">ポップアップを取り扱う</h3>
<p>以下の追加情報はメニューやポップアップの操作に関するものです。</p>
<dl>
<dt>メニューやポップアップを開く</dt>
<dd>ほとんどのメニューやポップアップは、要素に結び付けられていれば自動的に開かれます。スクリプトを使ってポップアップを開くには、 <code>openPopup</code> メソッドか <code>openPopupAtScreen</code> を使います。ポップアップの開き方についてのより詳しい情報は<a href="/ja/docs/XUL/PopupGuide/OpenClose#Opening_a_Popup">ポップアップを開く</a>もしくは<a href="/ja/docs/XUL/PopupGuide/OpenClose#Opening_Menus">メニューを開く</a>を参照して下さい。</dd>
<dt>メニューやポップアップを閉じる</dt>
<dd>ポップアップの閉じ方に関する情報は<a href="/ja/docs/XUL/PopupGuide/OpenClose#Closing_a_Popup_with_the_hidePopup_method">ポップアップを閉じる</a>もしくは <a href="/ja/docs/XUL/PopupGuide/OpenClose#Closing_Menus">メニューを閉じる</a>を参照して下さい。</dd>
<dt>ポップアップの配置方法</dt>
<dd>ポップアップのスクリーン上の位置を決定する方法や、ポップアップの位置を他の要素に揃える方法は、<a href="/ja/docs/XUL/PopupGuide/Positioning">ポップアップの配置</a>を参照して下さい。</dd>
<dt>ポップアップが開かれているかどうか確かめる</dt>
<dd>ポップアップやメニューが開かれているかどうかを確認するには、<a href="/ja/docs/XUL/PopupGuide/OpenClose#Determining_if_a_Popup_is_Open">ポップアップが開いているかどうか判別する</a>を参照して下さい。</dd>
<dt>ポップアップを移動する</dt>
<dd>ポップアップは <code>moveTo</code> メソッドを使って移動する事ができます。<a href="/ja/docs/XUL/PopupGuide/MoveResize#Moving_a_Popup">ポップアップの移動</a>を参照して下さい。</dd>
<dt>ポップアップをリサイズする</dt>
<dd><code>sizeTo</code> メソッドを使うとポップアップの大きさを調整する事ができます。<a href="/ja/docs/XUL/PopupGuide/MoveResize#Resizing_a_Popup">ポップアップのリサイズ</a>を参照して下さい。</dd>
<dt>メニューをボタンに取り付ける</dt>
<dd>ボタンが押された時にメニューを表示させる方法を知りたければ、<a href="/ja/docs/XUL/PopupGuide/MenuButtons">メニューボタン</a>を参照して下さい。</dd>
<dt>メニューのアイテムの機能</dt>
<dd>メニュー上のアイテムの様々な機能を学ぶには、<a href="/ja/docs/XUL/PopupGuide/MenuItems">menuitem 要素の機能</a>をご覧下さい。</dd>
<dt>メニューのアイテムを変更する</dt>
<dd>メニューに要素を追加、挿入、削除するには<a href="/ja/docs/XUL/PopupGuide/MenuModification">メニューの変更</a>をご覧下さい。</dd>
<dt>ポップアップ開閉時のイベント</dt>
<dd>ポップアップが開かれる時には <a href="/ja/docs/XUL/PopupGuide/PopupEvents#The_popupshowing_event">popupshowing</a> イベントと <a href="/ja/docs/XUL/PopupGuide/PopupEvents#The_popupshown_event">popupshown</a> イベントが発生します。ポップアップが閉じられる時には <a href="/ja/docs/XUL/PopupGuide/PopupEvents#The_popuphiding_event">popuphiding</a> イベントと <a href="/ja/docs/XUL/PopupGuide/PopupEvents#The_popuphidden_event">popuphidden</a> イベントが発生します。これらのイベントに関する情報は<a href="/ja/docs/XUL/PopupGuide/PopupEvents">ポップアップイベント</a>をご覧下さい。</dd>
<dt>ポップアップ内部でのキーの扱い</dt>
<dd>メニューやパネル内部でどのようにしてキーが扱われるかについての情報は<a href="/ja/docs/XUL/PopupGuide/PopupKeys">ポップアップ内部でのキーの扱い</a>を参照してください。</dd>
<dt>メニューに関するプラットフォーム固有の注意事項</dt>
<dd>Macintosh で Application メニューを作成する方法など、特定のプラットフォームでメニューを扱うときの注意事項については、<a href="/ja/docs/XUL/PopupGuide/PlatformMenus">プラットフォームごとの特殊なメニューに関する考察</a>を参照して下さい。</dd>
</dl>
<h3 id="Using_Popups_in_Extensions" name="Using_Popups_in_Extensions">拡張機能でポップアップを使う</h3>
<p>拡張機能では、メニューバーのメニューやコンテキストメニューにメニューアイテムを追加する事が出来ます。さらに、全く新しいメニューを追加する事も可能です。例えば、拡張機能専用のダイアログを開くための新しいコマンドをツールメニューに追加したいことがあるかもしれません。また、ブラウザのコンテキストメニューにアイテムを追加する拡張機能の作成もよく行われます。詳しくは<a href="/ja/docs/XUL/PopupGuide/Extensions">拡張機能におけるメニューとポップアップの使用</a>を参照して下さい。</p>
|
