|
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 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar |
@@ -482,6 +482,37 @@ The vertical separator character is taken from "tpl_vert" in 'fillchars'. |
482 | 482 | You can customize the appearance of the tab page labels using the highlight |
483 | 483 | groups: |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill| |
484 | 484 |
|
| 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 | + |
485 | 516 | ============================================================================== |
486 | 517 | 6. Setting 'guitablabel' *setting-guitablabel* |
487 | 518 |
|
|
0 commit comments