「JS フォーマット」の版間の差分
バージョンの表記を修正 |
空行と改行の除去 |
||
| 1行目: | 1行目: | ||
__toc__ | __toc__ | ||
EmEditor 用マクロ「Format HTMl, Javascript, Css format for Emeditor」(FHTML.jsee)を Mery 用「[[テキスト整形]]」マクロ(2019/06/01版 スターターパック)に移植して利用できるようにします。 | EmEditor 用マクロ「Format HTMl, Javascript, Css format for Emeditor」(FHTML.jsee)を Mery 用「[[テキスト整形]]」マクロ(2019/06/01版 スターターパック)に移植して利用できるようにします。 | ||
* Mery には [https://ja.wikipedia.org/wiki/HTML_Tidy HTML Tidy] ライブラリによる HTML 整形機能が標準搭載されているので、主として JavaScript コードの整形を目的とした使用を想定しています (編者は WEB 開発とは無縁で HTML, CSS などについての知見がないため、Mery の JScript マクロ用のソースコードにたいしてしか動作確認していません)。 | * Mery には [https://ja.wikipedia.org/wiki/HTML_Tidy HTML Tidy] ライブラリによる HTML 整形機能が標準搭載されているので、主として JavaScript コードの整形を目的とした使用を想定しています (編者は WEB 開発とは無縁で HTML, CSS などについての知見がないため、Mery の JScript マクロ用のソースコードにたいしてしか動作確認していません)。 | ||
* Mery 用のマクロとして実行できるよう改編していますが、基本的に元のマクロの動作内容の根幹部分を改変してはいません(元コードにたいするデバッグもしていません)。 実行したさいのエラーの発生などは、オリジナルのコードに由来するものかもしれません。 | * Mery 用のマクロとして実行できるよう改編していますが、基本的に元のマクロの動作内容の根幹部分を改変してはいません(元コードにたいするデバッグもしていません)。 実行したさいのエラーの発生などは、オリジナルのコードに由来するものかもしれません。 | ||
| 29行目: | 28行目: | ||
== FHTML.jsee を Mery に対応させる == | == FHTML.jsee を Mery に対応させる == | ||
以下で説明している内容で書き換えることにより FHTML.jsee をMery 用のマクロとして利用できるようになります (「マクロのカスタマイズ」に登録して [ マクロ ] メニューやショートカットから実行可)。 | 以下で説明している内容で書き換えることにより FHTML.jsee をMery 用のマクロとして利用できるようになります (「マクロのカスタマイズ」に登録して [ マクロ ] メニューやショートカットから実行可)。 | ||
'''1.''' 『[https://www.emeditor.com/files/fhtml-jsee/ Macro – Format HTML, Javascript, CSS, XML for EmEditor – EmEditor (Text Editor)]』[https://www.emeditor.com/files/fhtml-jsee/] の実体ファイル FHTML.jsee をダウンロードして、Mery¥Macros¥ フォルダ配下にコピー。<br> | '''1.''' 『[https://www.emeditor.com/files/fhtml-jsee/ Macro – Format HTML, Javascript, CSS, XML for EmEditor – EmEditor (Text Editor)]』[https://www.emeditor.com/files/fhtml-jsee/] の実体ファイル FHTML.jsee をダウンロードして、Mery¥Macros¥ フォルダ配下にコピー。<br> | ||
ファイル拡張子を「.jsee」 ⇒ 「'''.js'''」に変更(お好みでベース名も変更)して Mery で開きます。 | ファイル拡張子を「.jsee」 ⇒ 「'''.js'''」に変更(お好みでベース名も変更)して Mery で開きます。 | ||
以下、ソースコード(JScript)内の 下 ⇒ 上 の順に変更/挿入箇所を説明します。 | 以下、ソースコード(JScript)内の 下 ⇒ 上 の順に変更/挿入箇所を説明します。 | ||
---- | ---- | ||
| 43行目: | 42行目: | ||
return js_beautify(code, (indent_size || 1), (indent_character || '\t')); | return js_beautify(code, (indent_size || 1), (indent_character || '\t')); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''3.''' ソースコード '''147 - 148''' 行目を書き換え | '''3.''' ソースコード '''147 - 148''' 行目を書き換え | ||
| 52行目: | 50行目: | ||
document.selection.SetActivePoint(mePosView, 1, currentLine); // ◆定数名を変更 for Mery◆ | document.selection.SetActivePoint(mePosView, 1, currentLine); // ◆定数名を変更 for Mery◆ | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''4.''' ソースコード '''132''' 行目に挿入<br> | '''4.''' ソースコード '''132''' 行目に挿入<br> | ||
| 102行目: | 99行目: | ||
word = word.replace(comment_tag, ProcessCommentBlock); | word = word.replace(comment_tag, ProcessCommentBlock); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''7.''' ソースコード '''116''' 行目を書き換え | '''7.''' ソースコード '''116''' 行目を書き換え | ||
| 109行目: | 105行目: | ||
var currentLine = document.selection.GetActivePointY(mePosView); // ◆定数名を変更 for Mery◆ | var currentLine = document.selection.GetActivePointY(mePosView); // ◆定数名を変更 for Mery◆ | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''8.''' ソースコードの '''先頭行''' に以下のコードを挿入する | '''8.''' ソースコードの '''先頭行''' に以下のコードを挿入する | ||
| 145行目: | 140行目: | ||
9. 上書き保存(拡張子 '''.js''')して、「マクロのカスタマイズ」に登録します。<br> | 9. 上書き保存(拡張子 '''.js''')して、「マクロのカスタマイズ」に登録します。<br> | ||
※ または [ マクロ ] メニューの [ これを選択(T) ] でも登録可。 | ※ または [ マクロ ] メニューの [ これを選択(T) ] でも登録可。 | ||
</div> | </div> | ||
編集モードが「JavaScript」や「[[Mery Macro JS]]」(または Mery_Macro_JS や MeryMacroJS でも可)であれば、マクロのソースコードを で美しく(?)整形することができるようになります。 | 編集モードが「JavaScript」や「[[Mery Macro JS]]」(または Mery_Macro_JS や MeryMacroJS でも可)であれば、マクロのソースコードを で美しく(?)整形することができるようになります。 | ||
* 選択範囲があれば選択範囲内のコードを整形、選択範囲なしでマクロを実行するとアクティブな文書全体を選択範囲にして整形します。 | * 選択範囲があれば選択範囲内のコードを整形、選択範囲なしでマクロを実行するとアクティブな文書全体を選択範囲にして整形します。 | ||
| 152行目: | 148行目: | ||
* FHTML.jsee の元からの仕様により、「htm/xml/css/**script」をふくむ編集モード名でしか使用できません (追加コードにより [[Mery Macro JS]] にも対応させています)。 適合しない文書にたいして実行すると、マクロがエラーを吐いたり編集中の文書が壊れたりすることがありますが、UNDO 操作(Ctrl+Z)で復旧できるとおもいます。 | * FHTML.jsee の元からの仕様により、「htm/xml/css/**script」をふくむ編集モード名でしか使用できません (追加コードにより [[Mery Macro JS]] にも対応させています)。 適合しない文書にたいして実行すると、マクロがエラーを吐いたり編集中の文書が壊れたりすることがありますが、UNDO 操作(Ctrl+Z)で復旧できるとおもいます。 | ||
*「Format HTML, Javascript, CSS, XML」(FHTML.jsee)マクロ自体の最終更新年次が 2008 年なので、最新のコード規格に対応していない可能性があります。 | *「Format HTML, Javascript, CSS, XML」(FHTML.jsee)マクロ自体の最終更新年次が 2008 年なので、最新のコード規格に対応していない可能性があります。 | ||
</div | </div> | ||
== 「テキスト整形」マクロに移植する == | == 「テキスト整形」マクロに移植する == | ||
| 160行目: | 156行目: | ||
* <span style="color:#0000c0;">「[[テキスト整形]]」マクロは '''2019/06/01 版のスターターパッケージ''' を使用してください。</span> 古いバージョンの場合、ソースコードの書式(引数の変数や動作フラグ)がことなるため、追加コードを利用できません。 | * <span style="color:#0000c0;">「[[テキスト整形]]」マクロは '''2019/06/01 版のスターターパッケージ''' を使用してください。</span> 古いバージョンの場合、ソースコードの書式(引数の変数や動作フラグ)がことなるため、追加コードを利用できません。 | ||
* あらかじめ前節のとおり改編した「Format HTML, Javascript, CSS, XML」をマクロとして Mery に登録する必要があります。 登録していない状態で「テキスト整形」マクロから呼び出した場合は、自動的に「マクロのカスタマイズ」に登録されます。 | * あらかじめ前節のとおり改編した「Format HTML, Javascript, CSS, XML」をマクロとして Mery に登録する必要があります。 登録していない状態で「テキスト整形」マクロから呼び出した場合は、自動的に「マクロのカスタマイズ」に登録されます。 | ||
* <span style="color:#c00;">下の追加コードでは改編した「Format HTML, Javascript, CSS, XML」マクロ(FHTML.jsee)のファイル名を「JSフォーマット.js」にリネームして、Mery¥Macros¥ フォルダに配置してある前提になっています。</span><br> 「Format HTML, Javascript, CSS, XML」マクロのファイルパス(ファイル名)や登録名にあわせて <syntaxhighlight lang="javascript" inline>f.push(["JS フォーマット (&J)","O",function(_){</syntaxhighlight> 部分(メニュー項目としての表示名)や、<syntaxhighlight lang="javascript" inline>var macroPath = "Macros\\JSフォーマット.js"</syntaxhighlight> でのパス指定を書き換えてください。<br> ※ Mery¥Macros¥ フォルダ配下以外の場所に配置している場合は、フルパスで指定してください。 | * <span style="color:#c00;">下の追加コードでは改編した「Format HTML, Javascript, CSS, XML」マクロ(FHTML.jsee)のファイル名を「JSフォーマット.js」にリネームして、Mery¥Macros¥ フォルダに配置してある前提になっています。</span><br> 「Format HTML, Javascript, CSS, XML」マクロのファイルパス(ファイル名)や登録名にあわせて <syntaxhighlight lang="javascript" inline>f.push(["JS フォーマット (&J)","O",function(_){</syntaxhighlight> 部分(メニュー項目としての表示名)や、<syntaxhighlight lang="javascript" inline>var macroPath = "Macros\\JSフォーマット.js"</syntaxhighlight> でのパス指定を書き換えてください。<br> ※ Mery¥Macros¥ フォルダ配下以外の場所に配置している場合は、フルパスで指定してください。 | ||
<div class="warningbox"> | |||
* <span style="color:#c00;">追加したコマンドは '''未保存の『無題』文書''' (実体ファイルがないタブ)にたいしては使用できません。</span> 『無題』タブを JavaScript(拡張子 '''.js''')で保存して、編集モードを「JavaScript」(または「[[Mery Macro JS]]」)にした状態で実行してください。<br> ※「テキスト整形」マクロからの呼び出しではなく、「JSフォーマット.js」マクロ(Format HTML, Javascript, CSS, XML)を [ マクロ ] メニューから [[#実行|直接実行]] するなら『無題』のタブにも適用できます。 | * <span style="color:#c00;">追加したコマンドは '''未保存の『無題』文書''' (実体ファイルがないタブ)にたいしては使用できません。</span> 『無題』タブを JavaScript(拡張子 '''.js''')で保存して、編集モードを「JavaScript」(または「[[Mery Macro JS]]」)にした状態で実行してください。<br> ※「テキスト整形」マクロからの呼び出しではなく、「JSフォーマット.js」マクロ(Format HTML, Javascript, CSS, XML)を [ マクロ ] メニューから [[#実行|直接実行]] するなら『無題』のタブにも適用できます。 | ||
</div | </div> | ||
* 追加コードは、「テキスト整形」マクロ本体の更新(バージョンアップ)により使用できなくなることがあります。 | * 追加コードは、「テキスト整形」マクロ本体の更新(バージョンアップ)により使用できなくなることがあります。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 183行目: | 178行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== memo == | == memo == | ||
| 189行目: | 183行目: | ||
ライセンス違反やコードのエラーなどについてのご連絡は、こちらの「memo」節の '''[編集]''' よりお知らせください (おそらくは、このページを削除するかたちでしか対応できませんが...)。 | ライセンス違反やコードのエラーなどについてのご連絡は、こちらの「memo」節の '''[編集]''' よりお知らせください (おそらくは、このページを削除するかたちでしか対応できませんが...)。 | ||
スポンサーリンク