「TAB／半角空白トグル変換」を編集中 (節単位)

== 注意事項 ==
* このマクロの設定項目 <code>indentSize</code> の値と Mery の [オプション] の「タブの桁数」の設定値（または「[[プラグイン:EditorConfig|EditorConfig プラグイン]]」[https://www.haijin-boys.com/software/mery/mery-2-8-7] の <code>indent_size</code> の値）がことなると、「半角空白 ⇒ TAB」変換の可否判定や変換結果がうまくないかんじになる場合があります。
: EditorConfig で <code>indent_size</code> をカスタマイズしている場合、このマクロの設定は <syntaxhighlight lang="javascript" inline>var indentSize = 0</syntaxhighlight> にしてください（Mery Ver 3.0.x 以降）。
: ※「[[プラグイン:EditorConfig|EditorConfig プラグイン]]」は Ver 1.0.2 (2020/03/14) 以降の最新版を使用してください。

* <s>マルチカーソル／複数選択や</s> <span style="color:#c00;">矩形選択には非対応です。</span><br> 回避処理は入れていませんので、意図したとおりの結果にならなかったときは Undo (Ctrl＋Z) してください。<br><span style="color:#0000c0;"> ⇒　マルチカーソル対応版を追加しました</span>が、矩形選択からの実行は考慮していないままです（2020/07/02）。

; 優先ルール
* 「TAB＋半角空白」が混在する空白文字列からの実行では、つねに「TAB ⇒ 半角空白」変換になります（再度実行すれば「半角空白 ⇒ TAB」変換できます）。<br>

* 本来、全角空白は「空白をタブに変換」の対象外です。 <syntaxhighlight lang="javascript" inline>FullToHalf2 = false</syntaxhighlight> で全角空白をふくむ空白文字列を範囲選択している場合は、選択範囲をふくむ行全体が変換対象になります。
: また、選択範囲が複数行にまたがっている場合は、つねに論理行全体が変換対象になります。
: ※ <syntaxhighlight lang="javascript" inline>wholeLines = false</syntaxhighlight> のときは、行全体の変換なし。

; キャレット位置または選択範囲内の「TAB ⇔ 半角空白」変換
* <syntaxhighlight lang="javascript" inline>wholeLines = false</syntaxhighlight> のときで、選択範囲内に改行がある場合や、非空白文字（全角空白も含む）がある場合は変換しません。

* キャレット位置の空白文字列を変換するとき、行頭の TAB インデントから半角空白への変換では後ろの文字列がズレることはないようです<s>が、行の途中の TAB を半角空白に変換した場合や、TAB の区切り位置からズレた連続する半角空白幅を TAB に変換した場合は、うしろの文字列の先頭位置がズレます。</s><br><span style="color:#0000c0;"> ⇒　うしろの非空白文字列がズレないように対策しました</span>（2020/05/29 更新）。

: ※「連続する半角空白文字列」内の中途半端な位置から範囲選択して「半角空白 ⇒ TAB」変換すると、選択範囲よりうしろの文字列の先頭位置がズレます。

* 行の途中にある TAB ひとつを「TAB ⇒ 半角空白」変換するとき、TAB の見かけ上の幅が「タブの桁数」<code>indentSize</code> より小さいと、「TAB ⇒ 半角空白」したあとの半角空白の数が「タブの桁数」よりも少なくなります。
: ※「TAB ⇒ 半角空白」変換後にこのマクロを再実行しても「半角空白 ⇒ TAB」変換にならないことがあります。

; 行全体の「TAB ⇔ 半角空白」変換
* 複数行選択の状態から「TAB ⇔ 半角空白」変換したときに、選択範囲内の行のブックマーク設定が維持されるかどうかは Mery 本体のバージョンによってことなります。<br> 最新のベータバージョン（2020/05/29 時点で [https://www.haijin-boys.com/software/mery/mery-3-0-0 Ver 3.0.3]）ではブックマーク設定が維持されますが、2020/05/29 時点での <q>正式版</q> Ver 2.6.7 ではブックマーク設定がズレたり消えたりします。