diff --git a/doc/options.jax b/doc/options.jax index 280fabc99..ad55b2a73 100644 --- a/doc/options.jax +++ b/doc/options.jax @@ -1,4 +1,4 @@ -*options.txt* For Vim バージョン 9.2. Last change: 2026 Apr 06 +*options.txt* For Vim バージョン 9.2. Last change: 2026 Apr 07 VIM リファレンスマニュアル by Bram Moolenaar @@ -6924,6 +6924,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる グローバル 補完時のポップアップメニューのボーダーとオプションの装飾を定義する。値 はコンマ区切りのキーワードリストである。 + 統合された代替案については、'pumopt' を参照。 ボーダーのスタイル (最大 1 つ): "single" 細い罫線文字を使用する @@ -6956,8 +6957,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる 'pumheight' 'ph' 数値 (既定では 0) グローバル 挿入モード補完のポップアップメニューに表示される項目数の最大値。 - 0 のときはスペースの許す限り多く表示される。 - |ins-completion-menu| + 0 のときはスペースの許す限り多く表示される。|ins-completion-menu| + 統合された代替案については、'pumopt' を参照。 *'pummaxwidth'* *'pmw'* 'pummaxwidth' 'pmw' 数値 (既定では 0) @@ -6969,12 +6970,66 @@ Note 1番目の形式では、行全体がオプション指定に使われる このオプションは 'pumwidth' よりも優先される。 |ins-completion-menu|。 + 統合された代替案については、'pumopt' を参照。 + + *'pumopt'* +'pumopt' 文字列 (既定では "") + グローバル + 挿入モードの補完時に表示されるポップアップメニューを設定する。 + 値は、キーと値のペアおよびフラグをコンマで区切ったリストです。 + 値は、コンマ区切りの "key:value" ペアおよびフラグのリストである。 + + キーと値: + border:{style} ボーダースタイルを設定する (最大 1 つ) + "single" 細い罫線文字 + "double" 2 重の罫線文字 + "round" 丸い角 + "ascii" ASCII 文字 (-, |, +) + "custom:X;X;X;X;X;X;X;X" + セミコロンで区切られた8文字の次の順序: + 上、右、下、左、左上、右上、右下、左下 + height:{n} 表示する項目の最大数 (デフォルトは 0 で、スペー + スの許す限り多く表示する) + width:{n} 最小幅 (デフォルト 15) + maxwidth:{n} 最大幅 (デフォルトは 0 で制限なし)。 + これは width よりも優先される。テキストの切り + 詰めは、'fillchars' オプションの "trunc" 値で + 示される。 + opacity:{n} 不透明度のパーセント 0-100 (デフォルト 100)。 + 100 未満の場合、ポップアップメニュー越しに背後 + のコンテンツが透けて見える。 + + フラグ (値なし): + margin 左右のボーダーの内側に 1 セル分のスペースを追 + 加する。ボーダースタイルが必要。 + shadow 右端と下端に影を描く。 + + 罫線文字 ("single", "double", "round") を使用したボーダースタイルは、 + 'encoding' が "utf-8" かつ 'ambiwidth' が "single" の場合にのみ使用で + きる。 + + ハイライトグループ: + |hl-PmenuBorder| ボーダー文字に使用される + |hl-PmenuShadow| 影に使用される + + Note: 'pumopt' が設定されている場合、まずすべての値がデフォルト値にリ + セットされ、その後指定されたキーが適用される。指定されていないキーには + デフォルト値が適用される。 + + 例: > + :set pumopt=border:single + :set pumopt=border:double,margin,shadow + :set pumopt=height:10,width:20,opacity:80 + :set pumopt=border:custom:─;│;─;│;┌;┐;┘;└,shadow +< + 以下も参照: |ins-completion-menu|。 *'pumwidth'* *'pw'* 'pumwidth' 'pw' 数値 (既定では 15) グローバル 挿入モード補完のポップアップメニューに使用する幅の最小値。 |ins-completion-menu|. + 統合された代替案については、'pumopt' を参照。 *'pythondll'* 'pythondll' 文字列 (既定値はビルドに依存) diff --git a/en/options.txt b/en/options.txt index 064d66c9d..ffe463e44 100644 --- a/en/options.txt +++ b/en/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.2. Last change: 2026 Apr 06 +*options.txt* For Vim version 9.2. Last change: 2026 Apr 07 VIM REFERENCE MANUAL by Bram Moolenaar @@ -6886,6 +6886,7 @@ A jump table for the options with a short description can be found at |Q_op|. global Defines a border and optional decorations for the popup menu in completion. The value is a comma-separated list of keywords. + See |'pumopt'| for a consolidated alternative. Border styles (at most one): "single" use thin box-drawing characters @@ -6921,6 +6922,7 @@ A jump table for the options with a short description can be found at |Q_op|. Determines the maximum number of items to show in the popup menu for Insert mode completion. When zero as much space as available is used. |ins-completion-menu|. + See |'pumopt'| for a consolidated alternative. *'pummaxwidth'* *'pmw'* 'pummaxwidth' 'pmw' number (default 0) @@ -6932,12 +6934,67 @@ A jump table for the options with a short description can be found at |Q_op|. This option takes precedence over 'pumwidth'. |ins-completion-menu|. + See |'pumopt'| for a consolidated alternative. + + *'pumopt'* +'pumopt' string (default "") + global + Configures the popup menu used for Insert mode completion. + The value is a comma-separated list of key:value pairs and flags. + + Keys with values: + border:{style} set a border style (at most one): + "single" thin box-drawing characters + "double" double-line box-drawing characters + "round" rounded corners + "ascii" ASCII characters (-, |, +) + "custom:X;X;X;X;X;X;X;X" + eight characters separated by + semicolons, in the order: top, right, + bottom, left, topleft, topright, + botright, botleft + height:{n} maximum number of items to show (default 0, + meaning as much space as available) + width:{n} minimum width (default 15) + maxwidth:{n} maximum width (default 0, meaning no limit). + This takes precedence over width. + Truncated text is indicated by "trunc" value + of 'fillchars' option. + opacity:{n} opacity percentage 0-100 (default 100). + When less than 100, background content shows + through the popup menu. + + Flags (no value): + margin adds one-cell spacing inside the left and + right border. Requires a border style. + shadow draws a shadow at the right and bottom edges. + + Border styles using box-drawing characters ("single", "double", + "round") are only available when 'encoding' is "utf-8" and + 'ambiwidth' is "single". + + Highlight groups: + |hl-PmenuBorder| used for the border characters + |hl-PmenuShadow| used for the shadow + + Note: When 'pumopt' is set, all values are reset to their defaults + first, then the specified keys are applied. Unspecified keys get + their default values. + + Examples: > + :set pumopt=border:single + :set pumopt=border:double,margin,shadow + :set pumopt=height:10,width:20,opacity:80 + :set pumopt=border:custom:─;│;─;│;┌;┐;┘;└,shadow +< + See also: |ins-completion-menu|. *'pumwidth'* *'pw'* 'pumwidth' 'pw' number (default 15) global Determines the minimum width to use for the popup menu for Insert mode completion. |ins-completion-menu|. + See |'pumopt'| for a consolidated alternative. *'pythondll'* 'pythondll' string (default depends on the build)