「テキスト整形」を編集中 (節単位)

== 拡張コード：書式 ==
=== コマンド ===
<syntaxhighlight lang="javascript" copy>
f.push(["コマンド名","オプション",function(引数){ 処理 }]);
</syntaxhighlight>
;オプション
:{|class="wikitable"
| <code>s</code> || 実行に範囲選択を要求 (require selection)
|-
| <code>c</code> || 実行にクリップボードを要求 (require clipboard)
|-
| <code>L</code> || 行選択してから処理 (select Line)
|-
| <code>O</code> || 非選択時はすべて選択してから処理 (select OR all)<br>※実験的機能（変更・廃止の可能性あり）
|}
:複数指定する場合、空白で区切ります。順序は問いません。<br>※仕様上、<code>0-9 A-Z a-z _</code> 以外の文字ならば区切りと判定されますが、空白を推奨します。
;引数
:第1引数に [[マクロリファレンス:Selection_インターフェイス#Text_プロパティ|Document.Selection.Text]] が、<br>第2引数に [[マクロリファレンス:Selection_インターフェイス|Document.Selection]] が渡されます。
;処理
:String (文字列) か Array (配列) を return すると、選択範囲を置換してカーソルを移動します。それ以外 (undefined など) の場合は、選択範囲に対し何もしません。
:なお、処理の途中で選択範囲が変化した場合、変化先で置換が行われます。
:{|class="wikitable"
! 例 !! 動作
|-
| <code>"abcd"</code> || abcd に置換後、abcd を選択 = <code>["","abcd",""]</code>
|-
| <code>["ab","cd"]</code> || abcd に置換後、ab と cd の間に移動
|-
| <code>["ab","cd",""]</code> || abcd に置換後、cd を選択
|}

=== サブメニュー ===
サブメニューを設けます。サブメニュー内サブメニュー（階層化）も可能です。
<syntaxhighlight lang="javascript" copy>
f.push(["メニュー名",function(f){
/* コマンド or サブメニュー or セパレーター */
}]);
</syntaxhighlight>

=== セパレーター ===
セパレーター（区切り）を設けます。

※半角ハイフン <code>-</code> は何個でも含められますが、他の文字は含められません。
<syntaxhighlight lang="javascript" copy>
f.push(["--------"]);
</syntaxhighlight>

=== replaceBatch メソッド ===
<code>replace</code> を連鎖させる記法（メソッドチェーン）の省略記法です。
<syntaxhighlight lang="javascript" copy>
f.push(["例 replaceBatch","s",function(_){
  return _.replaceBatch([ ["ABC","DEF"],["(1)","①"],[/GHI/gi,"JKL"] ]) }]);
</syntaxhighlight>
上記の処理は、下記と同じ処理になります。
<syntaxhighlight lang="javascript" copy>
f.push(["例 replace","s",function(_){
  return _.replace(/ABC/g,"DEF").replace(/\(1\)/g,"①").replace(/GHI/gi,"JKL") }]);
</syntaxhighlight>