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:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user