Skip to content

Commit b08a394

Browse files
authored
Merge pull request #2598 from h-east/update-tabpage
Update tabpage.{txt,jax}
2 parents b329ad4 + 2ed5e15 commit b08a394

2 files changed

Lines changed: 64 additions & 2 deletions

File tree

doc/tabpage.jax

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*tabpage.txt* For Vim バージョン 9.2. Last change: 2026 Feb 14
1+
*tabpage.txt* For Vim バージョン 9.2. Last change: 2026 Apr 25
22

33

44
VIM リファレンスマニュアル by Bram Moolenaar
@@ -483,6 +483,37 @@ GUI のタブページラインにはポップアップメニューがありま
483483
ハイライトグループを使用して、タブページラベルの外観をカスタマイズできます:
484484
|hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
485485

486+
タブパネルのスクロール: *tabpanel-scroll*
487+
488+
タブページのリストの合計高さが画面の表示高さを超えると、タブパネルはデフォルト
489+
でカレントタブページを含む "ページ" を表示し、そのページ以外のタブページを表示
490+
する方法は提供しない。
491+
492+
タブパネルをスクロール可能にするには、'tabpanelopt' に "scroll" を追加する: >
493+
:set tabpanelopt+=scroll
494+
495+
"scroll" が有効になっている場合、タブパネル領域上でのマウスホイールイベントは、
496+
タブページのリストを上下にスクロールする。スクロール動作は 'mousescroll' 設定
497+
に従う。
498+
タブパネル領域内でのホイールイベントはタブパネルによって処理され、
499+
|<ScrollWheelUp>| または |<ScrollWheelDown>| のマッピングはトリガーされない。
500+
501+
スクロール位置を示す垂直スクロールバーを追加するには、"scrollbar" を使用する: >
502+
:set tabpanelopt+=scrollbar
503+
504+
"scrollbar" の値は "scroll" の意味を含む。タブパネルの端に 1 列のスクロールバー
505+
が確保される。スクロールバーの列をクリックすると、サム (thumb) がクリック位置
506+
に移動し、サムをドラッグすることで連続的にスクロールできる。
507+
508+
"vert" と "scrollbar" を組み合わせると、スクロールバーはパネル側の垂直セパレー
509+
ターの横に描画される。
510+
511+
スクロールバーは、トラックに |hl-PmenuSbar| ハイライトグループを、サムに
512+
|hl-PmenuThumb| を使用する。
513+
514+
スクロールのオフセットは再描画後も保持さるが、 "scroll" または "scrollbar" を
515+
オフにしてから再びオンにするとリセットされる。
516+
486517
==============================================================================
487518
6. 'guitablabel' の設定 *setting-guitablabel*
488519

en/tabpage.txt

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*tabpage.txt* For Vim version 9.2. Last change: 2026 Feb 14
1+
*tabpage.txt* For Vim version 9.2. Last change: 2026 Apr 25
22

33

44
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -482,6 +482,37 @@ The vertical separator character is taken from "tpl_vert" in 'fillchars'.
482482
You can customize the appearance of the tab page labels using the highlight
483483
groups: |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
484484

485+
SCROLLING IN THE TABPANEL: *tabpanel-scroll*
486+
487+
When the total height of the tab page list exceeds the visible screen height,
488+
the tabpanel by default displays the "page" that contains the current tab page
489+
and offers no way to view tab pages outside that page.
490+
491+
To make the tabpanel scrollable, add "scroll" to 'tabpanelopt': >
492+
:set tabpanelopt+=scroll
493+
494+
With "scroll" enabled, mouse wheel events over the tabpanel area scroll the
495+
tab page list up or down. The scroll step follows the 'mousescroll' setting.
496+
Wheel events inside the tabpanel area are consumed by the tabpanel and do not
497+
trigger |<ScrollWheelUp>| or |<ScrollWheelDown>| mappings.
498+
499+
To additionally show a vertical scrollbar indicating the current scroll
500+
position, use "scrollbar": >
501+
:set tabpanelopt+=scrollbar
502+
503+
The "scrollbar" value implies "scroll". A one-column scrollbar is reserved at
504+
the edge of the tabpanel; clicking on the scrollbar column moves the thumb to
505+
the click position, and the thumb can be dragged to scroll continuously.
506+
507+
When "vert" is combined with "scrollbar", the scrollbar is drawn next to the
508+
vertical separator, on the panel side.
509+
510+
The scrollbar uses the |hl-PmenuSbar| highlight group for the track and
511+
|hl-PmenuThumb| for the thumb.
512+
513+
The scroll offset is remembered across redraws but is reset when "scroll" or
514+
"scrollbar" is toggled off and back on.
515+
485516
==============================================================================
486517
6. Setting 'guitablabel' *setting-guitablabel*
487518

0 commit comments

Comments
 (0)