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

==== アクセラレータ ====
ポップアップメニューのラベルの文字列に「半角アンパサンド記号 '''<q>&</q>''' ＋ '''半角英数字''' (またはアスキー記号)」を付記することで、アクセラレータ（アクセスキー）を設定することができる。

ラベルの先頭に連番数字などがある場合は、数字のまえにアンパサンド記号を付加して数字をアクセラレータにすることもできる。

そのさい、Shift キー付きでの入力が必要な記号は Shift キーなしで入力可能なキーのラベルと同一視される （e.g. 「'''&#'''」で '''<q>#</q>''' 記号をアクセラレータに指定した場合、JIS 配列のキーボードでは <kbd>3</kbd> キーがアクセラレータになる）。

* <span style="color:#0000c0;">'''<q>&</q>''' 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の '''<q>&</q>''' 記号のうしろの文字がアクセラレータになる</u></span>（ … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある）。
* <span style="color:#c00;">全角文字はアクセラレータにできない。</span>
* <span style="color:#c00;">ラベル文字列に含まれる '''<q>&</q>''' 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに '''<q>&</q>''' 記号を表示させたいときは、'''<q>&&</q>''' のように二重に記述する必要がある。</span>
** → 不特定の文字列 <syntaxhighlight lang="javascript" inline>String</syntaxhighlight> （文書内から抽出したテキストなど）をラベルにする場合は、あらかじめ <syntaxhighlight lang="javascript" inline>String.replace( /&/g, "&&" )</syntaxhighlight> と記述するとよい。
: ※ '''<q>&&</q>''' の記述で表示される '''<q>&</q>''' 記号は、アクセラレータにならない。
* <span style="color:#0000c0;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する（その場合は <kbd>Enter</kbd> キーで決定する）。</span>
** → アイテム数が多くなるメニューの場合、<syntaxhighlight lang="javascript" inline>menu.Add( "キャンセル & ", 0 );</syntaxhighlight> という行を 10 件とか 20 件ごとに挿入すると、スペースキーでポップアップメニュー内をスクロールさせることができる。
: ※「'''&<span style="background:#bfdfff;"> </span>'''」(半角アンパサンド＋半角空白) で半角スペースをアクセラレータに指定したアイテムは、<kbd>Space</kbd> キーがアクセスキーになる。
<syntaxhighlight lang="javascript">
/* アクセラレータを付加する */

var menu = CreatePopupMenu();
var piyo = "LOVE & PEACE & ...";

menu.Add( "アイテム1(&1)", 1 );		// [1] キーがアクセラレータ
menu.Add( "アイテム&2", 2 );			// [2] キーがアクセラレータ
menu.Add( "0&3 アイテム３", 3 );		// [3] キーがアクセラレータ
menu.Add( "&Hello &World &4", 4 );	// [H] キーがアクセラレータ
menu.Add( piyo.replace( /&/g, "&&" ) + "(&5)", 5 );	// [5] キーがアクセラレータ
menu.Add( piyo + "(&6)", 6 );		// スペースキーがアクセラレータ
menu.Add( "※※※※", 0, meMenuSeparator );	// meMenuSeparator があると第一引数の文字列は無視される
menu.Add( "キャンセル & ", 0 );		// スペースキーがアクセラレータ

// ５つめのアイテムは "LOVE & PEACE & ..." と表示されるが
// ６つめのアイテムは "LOVE  PEACE   ..." と表示される 

// ※ ６つめのアイテムと最後のアイテムでアクセラレータが重複している

var ret = menu.Track( 0 );
</syntaxhighlight>
<syntaxhighlight lang="javascript">
/* 10 行ごとに「キャンセル」項目を挿入し、スペースキーでスクロール可能にする */

var arr = document.Text.split( "\n" );
var menu = CreatePopupMenu();

for ( var i = 0; i < arr.length; i ++ ) {
  if ( i > 0 && i % 10 == 0 ) {
    menu.Add( "", 0, meMenuSeparator );
    menu.Add( "キャンセル & ", 0 );
    menu.Add( "", 0, meMenuSeparator );
  }
  menu.Add( arr[i].slice( 0, 30 ).replace( /&/g, "&&" ), i + 1 );
}

var y = menu.Track( 0 );
if ( y ) {
  document.selection.SetActivePoint( mePosLogical, 1, y );
}
</syntaxhighlight>