From e60df4bdf68cd0522470988f7974390c0c55edfd Mon Sep 17 00:00:00 2001 From: max Date: Mon, 7 Sep 2026 18:53:18 +0200 Subject: [PATCH] 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 --- README.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 38f3b7d..2561ea1 100644 --- a/README.md +++ b/README.md @@ -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