「検索ジャンプの include版」を編集中 (節単位)

== include版 ==
[[includeライブラリ]] を使用し、設定内容を外部ファイルに保存します（◆settingEnable 変数で設定。デフォルト: 有効）。

設定内容の読み込み／書き出しが可能になったので、<span style="color:#c00;">設定の変更はポップアップメニュー内の項目のチェック ON／OFF でできるようになります。 </span><br>

[[ファイル:Mery_ジャンプ_SS_2.png|link=https://www.haijin-boys.com/wiki/images/0/0f/Mery_ジャンプ_SS.png|スクリーンショット]]

<div id="注１" class="warningbox">
* あらかじめ [[includeライブラリ]] をインストールしてください。
* 設定内容の保存場所は '''Mery\Macros\MacroSettings\<ジャンプ>.json''' <br> または '''%AppData%\Mery\MacroSettings\<ジャンプ>.jso'''n です。<br> （※ <ジャンプ> の部分はこのマクロのファイル名）
</div>

* 「▼ 通常版 初期設定項目 ▼」以降の設定項目は『初期値』としてのみ利用され、ソースコード内の設定項目を直接書き換えする必要はありません。<br> ただし、settingEnable 変数を完全に無効にする場合は、ソースコード内で変更する必要があります。<br> → settingEnable を無効にした場合は「人柱版」と同じ状態になるので、設定変更はソースコードの直接編集（変数の true／false の変更）でおこなう必要があります。

* はじめての設定変更のさいにエラーが発生する場合は、以下の ①～③ を試行してください。
#　ポップアップメニューの「設定内容を初期化する」を実行して、ファイルを確認する<br> （ → JSON ファイルを新規作成して設定値を書き出します）。
#　ポップアップメニューの「JSON ファイルを開く」を実行して、ファイルを確認する。
#　JSON ファイルが正常に作成されない場合は、同梱の「ジャンプ.json」を '''上記の "設定ファイルの保存場所" フォルダ''' に配置してください。

:<span style="color:#c00;">※「JSON ファイルの初期化」コマンドでファイルチェックのコードに不備があったので修正しました。 (2019/04/16)</span>

* 設定変更メニューを組み込んでいるため、「検索設定の変更」オプションが有効のときは、検索語が他の行でヒットしなかった場合でもポップアップメニューを表示します。<br> ただし、複数行選択状態で実行した場合（「表示行」で選択範囲が折り返しを含む場合も）、「英単語のみ」オプションが有効なときや「空行／空白行」がオプション無効のときに検索条件にたいして「無効な検索文字列」を検索した場合は、ポップアップメニューを表示せず、ステータスバーにエラー内容を表示します。

※ include版ではドキュメントの行数制限（9,999,999行）があります。

▼ 追加機能 ▼

* 検索のさいに「英単語のみ検索」するかしないかを選択できます（◆変数で設定）。<br> これにより、ソースコードの１文字変数（''e.g. '''var s''';''）や '''<nowiki><a></nowiki>''' タグなどの検索がしやすくなります。

:* 「英単語のみ」オプションが有効のときは、マクロ実行前の選択範囲の有無によらず、キャレット位置の '''単語''' を自動選択して既存の選択範囲から置きかえます 。
:* <span style="color:#c00;">「英単語のみ」オプションを有効にして検索できるのは英単語（JavaScript の正規表現で '''\w+''' ）のみです。</span> <br> 単語の自動選択には Mery ビルトインのメソッドを使用しているので、英文でなくても単語の範囲選択までは行いますが、<span style="color:#c00;">日本語の文字列は検索できません。</span> <br> また、英文・欧文でも各種記号や空白文字、ascii 範囲外のアルファベットを使った単語でも検索できません。
:* このオプションを有効にした場合は正規表現を使用しての検索になるので、処理がやや遅くなります。

<div id="注２" class="warningbox">
* メニューに検索ヒットした行が表示されないときは、<br> メニューの「英単語のみ」のチェックをはずしてください。
</div>

* 文字列の検索のさいに「ヒット件数表示」オプションが有効な場合、選択範囲が「何件目」のヒット箇所かの表示を追加します（ジャンプしたあとの選択範囲が「何件目」のヒット箇所かも表示します）。