Skip to content

Update tabpage.{txt,jax} #2598

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
h-east merged 2 commits into from
Apr 26, 2026
Merged

Update tabpage.{txt,jax} #2598

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0189276
Update tabpage.{txt,jax}
h-east Apr 25, 2026
2ed5e15
Fix by review
h-east Apr 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 32 additions & 1 deletion doc/tabpage.jax
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*tabpage.txt* For Vim バージョン 9.2. Last change: 2026 Feb 14
*tabpage.txt* For Vim バージョン 9.2. Last change: 2026 Apr 25


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

タブパネルのスクロール: *tabpanel-scroll*

タブリストの合計高さが画面の表示高さを超えると、タブパネルはデフォルトでカレン
Copy link
Copy Markdown
Contributor

@tsuyoshicho tsuyoshicho Apr 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

タブページで1つの固有名になっているようなので、説明前出現ではありますが

When the total height of the tab page list exceeds the visible screen height,

としている以上

Suggested change
タブリストの合計高さが画面の表示高さを超えると、タブパネルはデフォルトでカレン
タブページのリストの合計高さが画面の表示高さを超えると、タブパネルはデフォルトでカレン

(改行はケアしていません)

他との兼ね合いも含めて、このように定形訳にしたほうがいい気がします

Copy link
Copy Markdown
Member Author

@h-east h-east Apr 26, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

今回に限らず、昔から原文の "tab ～" を "tab page ～" に直しているのは私です。今回も直しました。で日本語の直し忘れです。
ところで 'tabpanelopt' から "scrollbar" 項目削除になりました。(デフォルトでon、というか常に on)
vim/vim#20052 (comment)

Copy link
Copy Markdown
Contributor

@tsuyoshicho tsuyoshicho Apr 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

あ、そうなのですね

トタブページを含む "ページ" を表示し、そのページ以外のタブページを表示する方法
は提供しない。

タブパネルをスクロール可能にするには、'tabpanelopt' に "scroll" を追加する: >
:set tabpanelopt+=scroll

"scroll" が有効になっている場合、タブパネル領域上でのマウスホイールイベントは、
タブページのリストを上下にスクロールする。スクロール動作は 'mousescroll' 設定
に従う。
タブパネル領域内でのホイールイベントはタブパネルによって処理され、
|<ScrollWheelUp>| または |<ScrollWheelDown>| のマッピングはトリガーされない。

スクロール位置を示す垂直スクロールバーを追加するには、"scrollbar" を使用する: >
:set tabpanelopt+=scrollbar

"scrollbar" の値は "scroll" の意味を含む。タブパネルの端に 1 列のスクロールバー
が確保される。スクロールバーの列をクリックすると、サム (thumb) がクリック位置
に移動し、サムをドラッグすることで連続的にスクロールできる。

"vert" と "scrollbar" を組み合わせると、スクロールバーはパネル側の垂直セパレー
ターの横に描画される。

スクロールバーは、トラックに |hl-PmenuSbar| ハイライトグループを、サムに
|hl-PmenuThumb| を使用する。

スクロールのオフセットは再描画後も保持さるが、 "scroll" または "scrollbar" を
オフにしてから再びオンにするとリセットされる。

==============================================================================
6. 'guitablabel' の設定 *setting-guitablabel*

Expand Down
33 changes: 32 additions & 1 deletion en/tabpage.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*tabpage.txt* For Vim version 9.2. Last change: 2026 Feb 14
*tabpage.txt* For Vim version 9.2. Last change: 2026 Apr 25


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

SCROLLING IN THE TABPANEL: *tabpanel-scroll*

When the total height of the tab page list exceeds the visible screen height,
the tabpanel by default displays the "page" that contains the current tab page
and offers no way to view tab pages outside that page.

To make the tabpanel scrollable, add "scroll" to 'tabpanelopt': >
:set tabpanelopt+=scroll
With "scroll" enabled, mouse wheel events over the tabpanel area scroll the
tab page list up or down. The scroll step follows the 'mousescroll' setting.
Wheel events inside the tabpanel area are consumed by the tabpanel and do not
trigger |<ScrollWheelUp>| or |<ScrollWheelDown>| mappings.

To additionally show a vertical scrollbar indicating the current scroll
position, use "scrollbar": >
:set tabpanelopt+=scrollbar
The "scrollbar" value implies "scroll". A one-column scrollbar is reserved at
the edge of the tabpanel; clicking on the scrollbar column moves the thumb to
the click position, and the thumb can be dragged to scroll continuously.

When "vert" is combined with "scrollbar", the scrollbar is drawn next to the
vertical separator, on the panel side.

The scrollbar uses the |hl-PmenuSbar| highlight group for the track and
|hl-PmenuThumb| for the thumb.

The scroll offset is remembered across redraws but is reset when "scroll" or
"scrollbar" is toggled off and back on.

==============================================================================
6. Setting 'guitablabel' *setting-guitablabel*

Expand Down