「利用者:Sukemaru」を編集中 (節単位)

==== サブメニュー ====
サブメニューを組みこむ場合、通常はそれぞれの PopupMenu オブジェクトをあらかじめ宣言しておくものだが、[[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] 内の第二引数で定義することもできる。

[[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] が大量に並んでいる項目群の一部をサブメニュー化して整理したくなったときなどに、サブメニューオブジェクトの宣言行を用意しなくて済むので便利である。

サブメニューを多重に含むコードの場合、字下げ（インデント）を活用することで、メニューの階層構造を把握しやすくできる。

<syntaxhighlight lang="javascript">
var mainMenu = CreatePopupMenu();
mainMenu.Add( "アイテム１", 1 );
mainMenu.AddPopup( "サブメニュー１", subMenu1 = CreatePopupMenu() );
  subMenu1.Add( "アイテム２", 2 );
  subMenu1.AddPopup( "サブメニュー２", subMenu2 = CreatePopupMenu() );
    subMenu2.Add( "アイテム３", 3 );

var r = mainMenu.Track( 0 );
Alert( r > 0 ? mainMenu.GetText( r ) : "キャンセル" );
</syntaxhighlight>

* 配列やオブジェクトからポップアップメニューの生成をするときにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、<span style="color:#c00;">要素が不定数の配列やオブジェクトを複数のサブメニューに振り分けるのは簡単ではない…。</span>

: →　組み込み関数「[[ポップアップメニューを手軽に扱う]]」や「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にして自力でコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない。
: ※ 自動分割サブメニューのページに「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する#サンプルコード２|サンプルコード２]] (簡易版)」を追加した。
: 「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する#サンプルコード１|サンプルコード１]]」の組み込み関数ではサブメニューオブジェクト専用の配列 smArray を用意して <code>smArray.push( CreatePopupMenu() );</code>　→　<code>menu.AddPopup( label, smArray[ smId ] );</code>　としているが、サンプルコード２のようにループ処理内で <code>subMenu = CreatePopupMenu();</code> を使いまわしするだけでも新規のサブメニューアイテムを生成できるようだ。

* [[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] では [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|Add() メソッド]] の第三引数（''meMenuChecked, meMenuGrayed, meMenuSeparator''）は使用できない。
: サブメニュー内のすべてのアイテムが無効（グレーアウト）になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように（またはグレーアウトされるように） <code>PopupMenu.AddPopup()</code> 周りを [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲うしかない（※ メニューの階層構造が複雑な場合に、ソースコードが見づらくなってしまうが…）。

<syntaxhighlight lang="javascript">
// e.g. 編集モードが Text ならサブメニューを表示する
// ※ Text 以外ならグレーアウトさせた "サブメニュー" アイテムを表示

var menu1 = CreatePopupMenu();
var menu2 = CreatePopupMenu();

if ( document.Mode == "Text" ) {
  menu1.AddPopup( "サブメニュー", menu2 );
    menu2.Add( "アイテム２", 2 );
} else {
  menu1.Add( "サブメニュー", 0, meMenuGrayed );
}
menu1.Add( "アイテム１", 1 );

var r = menu1.Track( mePosMouse );
</syntaxhighlight>

: また、上出の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。
:: →　サブメニューオブジェクトを <code>AddPopup()</code> する前に孫アイテムを <code>Add()</code> しておき、チェックつきアイテムを含むかどうかの条件文でサブメニューオブジェクトのラベルを生成（サブメニューラベルの先頭に "'''*'''\t" や "'''✔'''" などを付加）してから <code>AddPopup()</code> することはできるが、 ''meMenuChecked''　とおなじチェックマークをつけられるわけではないので、コードが煩雑になるわりにあまり報われない努力となる…。