pi_paren - Vim日本語ドキュメント

pi_paren.txt  For Vim バージョン 9.1.  Last change: 2024 Nov 04


                  VIMリファレンスマニュアル    by Bram Moolenaar


対応するカッコの強調表示                        matchparen

このプラグインは標準プラグイン standard-plugin である。
'compatible' がオフのときだけ使用できる。

"loaded_matchparen" 変数を設定することで、このプラグインの読み込みを回避でき
る:


このプラグインは自動コマンドイベントの CursorMoved、CursorMovedI、WinEnter を
使って強調表示を再設定する。

                                        :NoMatchParen :DoMatchParen
このプラグインの機能を無効にするには次のコマンドを使う:


機能を有効に戻すには次のコマンドを使う:


強調表示には MatchParen が使われる。":highlight" コマンドを使って好きな色を設
定できる。例:


デフォルトでは、プラグインはカーソルの下の括弧とマッチする括弧の両方を、
hl-MatchParen ハイライトグループを使用してハイライトする。これにより、カーソ
ルのハイライトが MatchParen の色に置き換えられるため、カーソルが一時的に画面か
ら消える場合がある。これを防ぎ、プラグインがマッチする括弧のみをハイライトし、
(実質的にカーソルのスタイルを変更せずに) カーソルの下の括弧をハイライトしない
ようにするには、"matchparen_disable_cursor_hl" 変数を設定する:


オプション 'matchpairs' に設定されている文字が強調表示される。このオプションを
設定することで好きな文字を強調表示できる。Note 設定しても機能しない文字もある。
例えば、シングルクォートやダブルクォートのペアなどは、始点と終点が同じなので強
調表示できない。

対応するカッコを探すときには構文強調の属性が使われる。カーソル位置の文字が、文
字列やコメント以外のときは、文字列やコメントの中は無視される。名前に "string"
や "comment" が含まれている構文強調アイテムはすべて、文字列やコメントとして扱
われる。

カーソルの移動が遅くならないように、対応するカッコの検索には次の制限がある:
- ウィンドウに表示されている範囲だけ検索する。
- 閉じた折り畳みがあると処理に時間がかかるので、カーソル位置から 100 行以内の
  範囲だけ検索する。
- 長い行が構文強調表示されていると処理に時間がかかるので、カーソル位置から
  'synmaxcol' の二倍の範囲の文字だけ検索する。
- 300 ミリ秒でタイムアウト (挿入モードでは 60 ミリ秒)。これは変数の
  "g:matchparen_timeout" と "g:matchparen_insert_timeout" を設定することで変更
  できる。バッファ毎に設定する場合は "b:matchparen_timeout" と
  "b:matchparen_insert_timeout" を設定する。

% コマンドの動作を改善したい場合は matchit プラグインが使用できる。
matchit-install 参照。このプラグインを使うとコメント内のカッコをスキップする
こともできる。これは matchparen プラグインとの関連性はない。matchit プラグイン
は matchparen とは別のメカニズムを使っている。

==============================================================================
 vim:tw=78:ts=8:noet:ft=help:norl: