Restore the code spans a shell heredoc ate in the README

Also corrects the showDirectory entry, which is an enum now, and states
plainly that drag-to-dock is impossible in a webview view.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
max
2026-09-07 18:53:18 +02:00
co-authored by Claude Opus 5
parent 2865ced2f0
commit e60df4bdf6
+13 -4
View File
@@ -7,10 +7,10 @@ It shows up as a **Tabs** view in the Explorer — drag it wherever you want it,
## Two ways to use it
**Just the colours.** colours files by project wherever VS Code shows file
**Just the colours.** `verticalTabs.decorateFiles` colours files by project wherever VS Code shows file
decorations — the Explorer, the built-in **Open Editors** view, and the editor tabs. If colour coding is all you
want, use this and keep the built-in view: it drags to dock, shows file icons, and can focus every kind of tab.
Set it to to add a two-letter project badge such as for .
Set it to `colorAndBadge` to add a two-letter project badge such as `AC` for `Acme.Shop.Client`.
**The Tabs view.** A drawn list that the built-in view cannot be: a project border down each row, real spacing,
and file names that keep their extension. Costs drag-and-drop and file icons — see *Known limitations*.
@@ -54,8 +54,10 @@ the close button replaces on hover.
- `verticalTabs.colorByProject` — colour each row's left border by project (default `true`)
- `verticalTabs.borderWidth` — width of that border in pixels (default `3`)
- `verticalTabs.rowSpacing` — pixels between rows (default `2`)
- `verticalTabs.showProject` — also show the project name as text (default `true`)
- `verticalTabs.showDirectory` — also show the directory as text (default `true`)
- `verticalTabs.showProject` — also show the project name as text (default `true`); turn it off and the file
name gets the whole row, with the border still telling you the project
- `verticalTabs.showDirectory` — when to show the directory: `never`, `duplicates` (default — only when two
open tabs share a file name), or `always`
- `verticalTabs.allGroups` — list every editor group, not just the active one (default `true`)
- `verticalTabs.projectFiles` — file names or extensions that mark a project root
@@ -77,6 +79,13 @@ The twelve project colours are theme colours (`verticalTabs.project1` … `proje
icon set, since a webview cannot reach the active file-icon theme.
- Rows are drawn rather than native, so they do not pick up list styling from every theme the way a tree view
would, and there is no native drag-and-drop.
- **Drag to dock is not possible in this view, at all.** Dragging a row into the editor area needs
`TreeDragAndDropController` and its `text/uri-list` support, which only tree views have — a drag started
inside a webview iframe cannot be handed to the workbench. If dragging matters more than the borders and
spacing, use `decorateFiles` with the built-in Open Editors view instead.
- Decorations colour the Explorer as well as the Open Editors view; there is no way to target one. Git also
decorates modified files and only one colour wins, so a dirty file may show Git's colour rather than its
project's.
## Tests