Skip to content

Commit 2b1ee49

Browse files
h-easth-east
authored
Merge pull request #2094 from h-east/update-tabpanel
Update tabpage.{txt,jax}
2 parents 8a75d39 + 849e5d0 commit 2b1ee49

File tree

2 files changed

+129
-11
lines changed

2 files changed

+129
-11
lines changed

‎doc/tabpage.jax

Lines changed: 64 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*tabpage.txt* For Vim バージョン 9.1. Last change: 2024 Jul 12
1+
*tabpage.txt* For Vim バージョン 9.1. Last change: 2025 Jun 07
22

33

44
VIMリファレンスマニュアル by Bram Moolenaar
@@ -13,7 +13,8 @@
1313
2. コマンド |tab-page-commands|
1414
3. その他 |tab-page-other|
1515
4. 'tabline' の設定 |setting-tabline|
16-
5. 'guitablabel' の設定 |setting-guitablabel|
16+
5. 'tabpanel' の設定 |setting-tabpanel|
17+
6. 'guitablabel' の設定 |setting-guitablabel|
1718

1819
{|+windows| 機能がコンパイル時に無効になっていると、複数のタブページを使用でき
1920
ません}
@@ -366,9 +367,9 @@ GUI のタブページラインにはポップアップメニューがありま
366367
オプション 'tabline' を使って、タブページラベルを好みの表示に設定できます。こ
367368
れはあまり簡単ではないので、サンプルを用意してあります。
368369

369-
基本的には 'statusline' を参照してください。同じアイテムが 'tabline' で使用で
370-
きます。加えて、|tabpagebuflist()|、|tabpagenr()|、|tabpagewinnr()| という関数
371-
も使えます。
370+
基本的な情報については、'statusline' オプションを参照ください。同じ項目は
371+
'tabline' および 'tabpanel' オプションでも使用できます。さらに、
372+
|tabpagebuflist()|、|tabpagenr()|、|tabpagewinnr()| 関数も便利です。
372373

373374
タブページラベルの数は変化するので、オプションには式を使う必要があります。次の
374375
ように設定します: >
@@ -421,7 +422,64 @@ GUI のタブページラインにはポップアップメニューがありま
421422
う。利用できる表示領域はオプション 'columns' を確認してください。
422423

423424
==============================================================================
424-
5. 'guitablabel' の設定 *setting-guitablabel*
425+
5. 'tabpanel' の設定 *tabpanel* *setting-tabpanel*
426+
427+
タブパネルは、ウィンドウの横にタブページのラベルを表示する垂直サイドバーです。
428+
次のように表示されます:
429+
>
430+
+-----------+----------------------------------
431+
|(1) |text text text text text text text
432+
| ~/aaa.txt|text text text text text text text
433+
|(2) |text text text text text text text
434+
| ~/.vimrc |text text text text text text text
435+
|(3) |text text text text text text text
436+
| ~/bbb.js |text text text text text text text
437+
| ~/ccc.css|text text text text text text text
438+
| |text text text text text text text
439+
| |text text text text text text text
440+
| |text text text text text text text
441+
<
442+
タブパネルを設定するには、以下のオプションを使用します: 'tabpanel'、
443+
'showtabpanel'、'tabpanelopt'。
444+
'tabpanel' および 'showtabpanel' オプションは、'statusline' または 'tabline'
445+
オプションと同様の機能を持ちます。
446+
447+
'tabpanelopt' オプションの "columns:" 項目は、タブパネルの幅を指定します:
448+
>
449+
+------ この幅
450+
|
451+
<----+----->
452+
+-----------+----------------------------------
453+
|(1) |text text text text text text text
454+
| ~/aaa.txt|text text text text text text text
455+
|(2) |text text text text text text text
456+
<
457+
'tabpanelopt' オプションの "align:" 項目は、タブパネルをウィンドウの左側に表示
458+
するか右側に表示するかを決定します:
459+
>
460+
+----------------------------------+-----------
461+
|text text text text text text text|(1)
462+
|text text text text text text text| ~/aaa.txt
463+
|text text text text text text text|(2)
464+
<
465+
'tabpanelopt' オプションの "vert" 項目は、タブパネルとウィンドウの表示部分の間
466+
に垂直セパレーターを表示するかどうかを指定します:
467+
>
468+
+------ ここ
469+
|
470+
v
471+
+-----------+----------------------------------
472+
|(1) |text text text text text text text
473+
| ~/aaa.txt|text text text text text text text
474+
|(2) |text text text text text text text
475+
<
476+
垂直区切り文字は、'fillchars' の "tpl_vert" から取得されます。
477+
478+
ハイライトグループを使用して、タブページラベルの外観をカスタマイズできます:
479+
|hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
480+
481+
==============================================================================
482+
6. 'guitablabel' の設定 *setting-guitablabel*
425483

426484
GUI のタブページラインが表示されているとき、'guitablabel' を設定してタブページ
427485
ラベルの表示方法を指定できます。'tabline' とは違い、一度にタブページライン全体

‎en/tabpage.txt

Lines changed: 65 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*tabpage.txt* For Vim version 9.1. Last change: 2024 Jul 12
1+
*tabpage.txt* For Vim version 9.1. Last change: 2025 Jun 07
22

33

44
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -14,7 +14,8 @@ when used in combination with more than one tab page.
1414
2. Commands |tab-page-commands|
1515
3. Other items |tab-page-other|
1616
4. Setting 'tabline' |setting-tabline|
17-
5. Setting 'guitablabel' |setting-guitablabel|
17+
5. Setting 'tabpanel' |setting-tabpanel|
18+
6. Setting 'guitablabel' |setting-guitablabel|
1819

1920
{not able to use multiple tab pages when the |+windows| feature was disabled
2021
at compile time}
@@ -364,8 +365,8 @@ The 'tabline' option allows you to define your preferred way to tab pages
364365
labels. This isn't easy, thus an example will be given here.
365366

366367
For basics see the 'statusline' option. The same items can be used in the
367-
'tabline' option. Additionally, the |tabpagebuflist()|, |tabpagenr()| and
368-
|tabpagewinnr()| functions are useful.
368+
'tabline' and 'tabpanel' option. Additionally, the |tabpagebuflist()|,
369+
|tabpagenr()| and |tabpagewinnr()| functions are useful.
369370

370371
Since the number of tab labels will vary, you need to use an expression for
371372
the whole option. Something like: >
@@ -418,7 +419,66 @@ clever way when there is not enough room. Check the 'columns' option for the
418419
space available.
419420

420421
==============================================================================
421-
5. Setting 'guitablabel' *setting-guitablabel*
422+
5. Setting 'tabpanel' *tabpanel* *setting-tabpanel*
423+
424+
The tabpanel is a vertical sidebar that displays tab page labels along the
425+
side of the window. It looks like this:
426+
>
427+
+-----------+----------------------------------
428+
|(1) |text text text text text text text
429+
| ~/aaa.txt|text text text text text text text
430+
|(2) |text text text text text text text
431+
| ~/.vimrc |text text text text text text text
432+
|(3) |text text text text text text text
433+
| ~/bbb.js |text text text text text text text
434+
| ~/ccc.css|text text text text text text text
435+
| |text text text text text text text
436+
| |text text text text text text text
437+
| |text text text text text text text
438+
<
439+
To configure the tabpanel, use the following options: 'tabpanel',
440+
'showtabpanel' and 'tabpanelopt'.
441+
The 'tabpanel' and 'showtabpanel' options function similar to
442+
'statusline' or 'tabline'.
443+
444+
The "columns:" item of 'tabpanelopt' option specifies the width of the
445+
tabpanel:
446+
>
447+
+------ This width
448+
|
449+
<----+----->
450+
+-----------+----------------------------------
451+
|(1) |text text text text text text text
452+
| ~/aaa.txt|text text text text text text text
453+
|(2) |text text text text text text text
454+
<
455+
The "align:" item of the 'tabpanelopt' option determines whether the tabpanel
456+
will be displayed on the left or right side of the window:
457+
>
458+
+----------------------------------+-----------
459+
|text text text text text text text|(1)
460+
|text text text text text text text| ~/aaa.txt
461+
|text text text text text text text|(2)
462+
<
463+
The "vert" item of the 'tabpanelopt' option specifies whether a vertical
464+
separator should be displayed between the tabpanel and the display part of the
465+
window:
466+
>
467+
+------ This is
468+
|
469+
v
470+
+-----------+----------------------------------
471+
|(1) |text text text text text text text
472+
| ~/aaa.txt|text text text text text text text
473+
|(2) |text text text text text text text
474+
<
475+
The vertical separator character is taken from "tpl_vert" in 'fillchars'.
476+
477+
You can customize the appearance of the tab page labels using the highlight
478+
groups: |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
479+
480+
==============================================================================
481+
6. Setting 'guitablabel' *setting-guitablabel*
422482

423483
When the GUI tab pages line is displayed, 'guitablabel' can be used to
424484
specify the label to display for each tab page. Unlike 'tabline', which

0 commit comments

Comments
 (0)