「コメントマーク付け外し」の版間の差分

Masme (トーク | 投稿記録)
Masme版マクロ修正
Sukemaru (トーク | 投稿記録)
sukemaru版を追加
106行目: 106行目:
Sel.SetActivePoint(mePosLogical,1,by+1);
Sel.SetActivePoint(mePosLogical,1,by+1);
Sel.SetAnchorPoint(mePosLogical,1,ty);
Sel.SetAnchorPoint(mePosLogical,1,ty);
</source>
= sukemaru 版 =
行頭のコメントマーク付けはずし
* masame 版の設定用変数 indent = true の状態(インデントされたコメントマークを削除できる)を下地として、選択範囲内のもっとも字下げの少ない位置にあわせてコメントマークを付けられます。 <br> ※コードブロックのコメントアウトのさいに、各行の先頭位置が少しだけ分かりやすくなります。
* 空白行(タブ文字/半角スペースのみの行と、完全な空行)は無視します。
* 編集モードによる定義切替は、「コメントマーク付け外し」(masame版 2016/02/28)まま。
* <u>変数 comment の定義に "'''> '''" などの引用マークを指定すると、引用マークの付けはずしにも使用可。</u>
▼ '''注意事項''' (仕様上の制限) ▼
※字下げルールが「半角スペースのみ または タブ文字のみである」か、混在する場合には「半角スペースとタブ文字の出現順序が同じである」という前提になっています。 <br>  半角スペースとタブ文字が不規則に混在しているなら、変数 addByIndent = false; にして使ってください。
※行コメント文字の変数 comment = "hoge"; の <u>先頭が空白文字</u> だとアンコメントできません。
▼ '''使用例''' ▼
'''例1.''' 5行まとめて選択すると…
: ※indent = true;  addByIndent = false; のばあい (従来版とおなじ動作)
<source>
//comment 1      =>    |comment 1          =>    |//comment 1   
  //comment 2    =>    |  comment 2        =>    |//  comment 2 
      hoge        =>    |//      hoge        =>    |      hoge   
        fuga      =>    |//        fuga      =>    |        fuga 
          piyo    =>    |//          piyo    =>    |          piyo
</source>
'''例2.''' 下3行だけを選択すれば…
: ※indent = addByIndent = true; (sukemaru版 独自拡張1)
<source>
//comment 1      =>    |//comment 1        =>    |//comment 1   
  //comment 2    =>    |  //comment 2      =>    |  //comment 2 
      hoge        =>    |      //hoge        =>    |      hoge   
        fuga      =>    |      //  fuga      =>    |        fuga 
          piyo    =>    |      //    piyo    =>    |          piyo
</source>
'''例3.''' 5行まとめて選択しても、コメントアウトとアンコメントで別々の先頭位置を使うことができる
: ※indent = addByIndent = independent = true; (sukemaru版 独自拡張2)
<source>
//comment 1      =>    |comment 1          =>    |//comment 1   
  //comment 2    =>    |  comment 2        =>    |//  comment 2 
      hoge        =>    |      //hoge        =>    |      hoge   
        fuga      =>    |      //  fuga      =>    |        fuga 
          piyo    =>    |      //    piyo    =>    |          piyo
</source>
'''例4.''' コードブロックをまとめてコメントアウトするなら「'''引用の追加'''」マクロか「[[行の先頭に貼り付け]]」マクロのほうがよい...
: ※indent = false; にしても行頭にあるコメントマーク(e.g. 1行め)だけは削除されるので不適当 <br> ※以下の例は「'''引用の追加'''」マクロの 「//  C コメント」と「1つ削除」
<source>
//comment 1      =>    |// //comment 1      =>    |//comment 1   
  //comment 2    =>    |//  //comment 2    =>    |  //comment 2 
      hoge        =>    |//      hoge        =>    |      hoge   
        fuga      =>    |//        fuga      =>    |        fuga 
          piyo    =>    |//          piyo    =>    |          piyo
</source>
== ソースコード ==
ダウンロード: 「[[メディア:行コメント.zip|行コメント.zip]]」(アイコン入り)
<source lang="javascript">
#title = "行コメント"
#tooltip = "コメントマーク付けはずし"
#icon = "double-slash[1].ico"
// #icon = "Mery用 マテリアルデザインっぽいアイコン.icl",215
// 行コメント(sukemaru版)2018/10/25
// ●字下げされたコメントマークも削除 (true:する / false:しない)
var indent = true;
  // ※※ false なら 挿入/削除 する位置は「常に行頭」のみ ※※ 最優先フラグ ※※ (例1 の使い方)
  // true ならコメントマークを挿入する位置は addByIndent フラグで決定する
// ▲コメントマークを挿入する位置を字下げにあわせるか (true:あわせる / false:あわせない)
var addByIndent = true;
  // false なら「常に先頭」にコメントマークを挿入する  ※従来版では挿入パターンは false のみ
  // true なら字下げ位置にあわせてコメントマークを挿入する (例2 の使い方ができる)
  // ※ いずれの場合でも、indent = false なら addByIndent = false となる
// ■コメントアウトとアンコメントで別々の先頭位置を使うか (true:使う / false:使わない)
var independent = true;
  // false なら追加と削除で同じ判定基準の先頭位置検出をする
  // true なら追加と削除で別々の判定基準の先頭位置検出をする (例3 の使い方)
  // ※ いずれの場合でも、indent = false または addByIndent = false なら independent = false となる
// ▼sukemaru版 独自拡張の推奨設定 (例3の動作)
// indent = addByIndent = independent = true;
/* ここから「コメントマーク付け外し」(masame版)2016/02/28 より流用 */
// ◆行コメント文字の定義  ●初期値="//"
var comment = "// ";
  // ※「var comment = "> ";」にするか、下の定義切替ブロックに「case "text": return "> ";」 を追加すると「> 引用マーク」の付けはずしにもなる (sukemaru)
// ▼編集モードによる定義切替
comment = ( function() {
  switch ( document.Mode.toLowerCase() ) {
    case "bat":
      return "::";
    case "c#":  case "c++":  case "javascript":
      return "//";
    case "ini":  case "python":  case "ruby":
      return "#";
    case "visualbasic":  case "vbscript":
      return "'";
    default:
      return comment;
  }
} )();
/* ここまで「コメントマーク付け外し」(masame版 2016/02/28) より流用 */
var s = document.selection;
// 選択範囲を取得
var tx = s.GetTopPointX( mePosLogical );
var ty = s.GetTopPointY( mePosLogical );
var bx = s.GetBottomPointX( mePosLogical );
var by = s.GetBottomPointY( mePosLogical );
// 選択範囲の末尾が行頭にあるときの調整
if ( ty != by && bx == 1 )
  by --;
// 選択範囲を拡張
s.SetActivePoint( mePosLogical, 1, by );
s.EndOfLine( false, mePosLogical );
s.SetAnchorPoint( mePosLogical, 1, ty );
// コメントアウト/アンコメント処理
var st = s.Text;
var ad =  AddDeleteComment( st );
if ( ad != st ) // (処理の前後で変化なしなら undo 履歴に残さない)
  s.Text = ad;
// 選択範囲が空白行1行だけなら範囲選択を残さない
if ( s.Text == st && ty == by ) {
  s.SetActivePoint( mePosLogical, bx, by );
  s.SetAnchorPoint( mePosLogical, tx, ty );
}
// 拡張した選択範囲に復帰する
else { // ( ty < by )
  s.SetActivePoint( mePosLogical, 1, by + 1 );
  s.SetAnchorPoint( mePosLogical, 1, ty );
}
function AddDeleteComment( arg1 ) {
// 選択範囲の各行の字下げ量をチェックして、最少の字下げ位置にあわせてコメントアウトする
  var a = arg1.split( "\n" ); // 選択範囲を行単位に分解して配列 a に
  var b = []; // 各行の行頭の空白文字数を格納する => 削除の基準
  var c = []; // 配列 b をソートして最少の空白文字数を調べる => 追加の基準
  var d = []; // 非コメント行の空白文字数を格納する => 追加の基準
  // 選択範囲内の各行の行頭の空白文字数を取得 => 配列 b c に(最小値は 0 以上)
  for ( var i = 0; i < a.length; i ++ ) {
    var id = a[i].indexOf( a[i].match( /[^ \t]/ ) ); // 空白以外の文字の最初の出現位置
    // 空白行では -1 か null が返されるはず?(←ソートのジャマになる)なのでデタラメな数値にしておく
    id = ( id < 0 || id == null) ? 1000000 : id;
    b.push( id );  c.push( id );
    // 非コメント行の字下げ量を選り分けて取得 => 配列 d に
    var _id = ( a[i].substr( b[i], comment.length ) == comment ) ? 1000000 : id;
    d.push( _id );
  }
  c.sort( CompareForSort );
  d.sort( CompareForSort );
  // 各行をコメントアウト/アンコメント処理
  for ( var i = 0; i < a.length; i ++ ) {
    if ( a[i].match( /^[ \t]*$/ ) ) // 空白行はスルー
      continue;
    // 行頭の空白文字の直後がコメントマークかチェックして、コメントマークを削除/追加
    if ( a[i].substr( b[i], comment.length ) == comment ) {
      var uncomment = a[i].substr( 0, b[i] ) + a[i].substr( b[i] + comment.length );
      a[i] = ( indent || b[i] == 0 ) ? uncomment : comment + a[i];
    }
    else {
      var blank = ( independent ) ? a[i].slice( 0, d[0] ) : a[i].slice( 0, c[0] );
      var str = ( independent ) ? a[i].slice( d[0] ) : a[i].slice( c[0] );
      a[i] = ( indent && addByIndent ) ? blank + comment + str : comment + a[i];
    }
  }
  return a.join( "\n" );
}
/* 以下の関数は『sort メソッド (Array) (JavaScript) | MSDN』より
  https://msdn.microsoft.com/ja-jp/library/4b4fbfhk%28v=vs.94%29.aspx */
function CompareForSort( first, second ) {
// 文字コード昇順 (1, 10, 2, 20) ではなく、数値の大きさ (1, 2, 10, 20) でソート
  if ( first == second )  return 0;
  if ( first < second )  return -1;
  else  return 1; // ( first > second )
}
</source>
</source>
スポンサーリンク