Skip to content

Commit a2ac660

Browse files
authored
Merge pull request #7622 from microsoft/ui-customization
Add UI customization video
2 parents 23e7ae5 + 2ba1be8 commit a2ac660

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

docs/getstarted/userinterface.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ PageTitle: Visual Studio Code User Interface
77
DateApproved: 09/05/2024
88
MetaDescription: A quick overview of the Visual Studio Code user interface. Learn about the editor, window management, and special UI to handle source control, extension management, full text search and more.
99
---
10-
# User Interface
10+
# User interface
1111

1212
At its heart, Visual Studio Code is a code editor. Like many other code editors, VS Code adopts a common user interface and layout of an explorer on the left, showing all of the files and folders you have access to, and an editor on the right, showing the content of the files you have opened.
1313

14-
![Screenshot of the VS Code user interface, highlighting the five main areas.](images/userinterface/hero.png)
14+
<iframe width="560" height="315" src="https://www.youtube.com/embed/nORT3-kONgA" title="Transform your VS Code user interface" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
1515

16-
## Basic Layout
16+
## Basic layout
1717

1818
VS Code comes with a simple and intuitive layout that maximizes the space provided for the editor, while leaving ample room to browse and access the full context of your folder or project. The user interface is divided into five main areas:
1919

@@ -23,6 +23,8 @@ VS Code comes with a simple and intuitive layout that maximizes the space provid
2323
* **Activity Bar** - Located on the far left-hand side. Lets you switch between views and gives you additional context-specific indicators, like the number of outgoing changes when Git is enabled. You can change the position of the Activity Bar.
2424
* **Panel** - An additional space for views below the editor region. By default, it contains output, debug information, errors and warnings, and an integrated terminal. The Panel can also be moved to the left or right for more vertical space.
2525

26+
![Screenshot of the VS Code user interface, highlighting the five main areas.](images/userinterface/hero.png)
27+
2628
>**Tip:** A Secondary Side Bar is also available to display views opposite the Primary Side Bar. You can show it with `kb(workbench.action.toggleAuxiliaryBar)` and drag a view from the Primary Side Bar to the Secondary Side Bar.
2729
2830
Each time you start VS Code, it opens up in the same state it was in when you last closed it. The folder, layout, and opened files are preserved.
@@ -31,7 +33,7 @@ Open files in each editor are displayed with tabbed headers (Tabs) at the top of
3133

3234
>**Tip:** You can move the Primary Side Bar to the right hand side by right-clicking the Activity Bar and selecting **Move Primary Side Bar Right** or toggle its visibility (`kb(workbench.action.toggleSidebarVisibility)`).
3335
34-
## Side by Side Editing
36+
## Side by side editing
3537

3638
You can open as many editors as you like side by side vertically and horizontally. If you already have an editor open, there are multiple ways of opening another editor to the side:
3739

@@ -52,7 +54,7 @@ When you have more than one editor open, you can switch between them quickly by
5254

5355
>**Tip:** You can resize editors and reorder them. Drag and drop the editor title area to reposition or resize the editor.
5456
55-
### Editor Groups
57+
### Editor groups
5658

5759
When you split an editor (using the **Split Editor** or **Open to the Side** commands), a new editor region (edit group) is created which can hold a group of items. You can open as many editor groups as you like side by side vertically and horizontally.
5860

@@ -68,7 +70,7 @@ You can drag and drop editor groups on the workbench, move individual tabs betwe
6870

6971
You can split the current editor without creating a new editor group with the **View: Split Editor in Group** command (`kb(workbench.action.splitEditorInGroup)`). To learn more about this editor mode and specific commands for navigating between the two sides, you can read the section in the [Custom Layout](/docs/editor/custom-layout.md#split-in-group) article.
7072

71-
### Floating Windows
73+
### Floating windows
7274

7375
You can move editors into their own floating windows with the **Move into New Window** or **Copy into New Window** (`kb(workbench.action.copyEditorToNewWindow)`) commands. To learn more about floating editor windows, you can read the section in the [Custom Layout](/docs/editor/custom-layout.md#floating-editor-windows) article.
7476

@@ -92,7 +94,7 @@ Sticky Scroll shows the starting lines of currently visible nested scopes at the
9294
9395
Sticky Scroll uses several different content models to create its headings. It is possible to choose between the outline provider model, the folding provider model, and the indentation model to determine which lines to display in the Sticky Scroll area. If a model is not available for the current language, VS Code falls back to the next model in the order given above. The default model initially used comes from the `setting(editor.stickyScroll.defaultModel)` setting.
9496

95-
### Indent Guides
97+
### Indent guides
9698

9799
The editor shows indentation guides (vertical lines) which help you quickly see matching indent levels. If you would like to disable indent guides, you can set `"editor.guides.indentation": false` in your user or workspace [settings](/docs/getstarted/settings.md).
98100

@@ -233,7 +235,7 @@ Zen Mode can be further tuned with the following settings:
233235
* `setting(zenMode.centerLayout)` - Use [Centered editor layout](#centered-editor-layout). Default `true`.
234236
* `setting(zenMode.silentNotifications)` - Do not display notifications. Default `true`.
235237

236-
### Centered Editor Layout
238+
### Centered editor layout
237239

238240
Centered editor layout allows you to center align the editor area. This is useful when working with a single editor on a large monitor. You can use the side borders to resize the view (hold down the `Alt` key to independently move the sides).
239241

0 commit comments

Comments
 (0)