You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update "Scrollbars" documentation with revised descriptions, improved structure, and new visuals. Rename and reorganize related image files. Remove outdated screenshots.
Copy file name to clipboardExpand all lines: docs/configuration/scrollbars.md
+21-31Lines changed: 21 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,63 +24,53 @@ Customize the editor scrollbars from the Color Scheme.
24
24
25
25
## Introduction
26
26
27
-
For some time, JetBrains IDEs started separating components from the IDE Themes to the Color Schemes.
28
-
Since the color schemes can be changed without affecting the UI, it makes sense that the color schemes control the appearance of elements tied with the Editor.
27
+
In recent versions, JetBrains IDEs began moving several UI components from global Themes to individual Color Schemes. This change allows for greater flexibility, as color schemes can be switched without altering the overall IDE user interface. It also ensures that editor elements—such as scrollbars—match the active coding environment.
29
28
30
-
Such examples are:
29
+
Examples of elements controlled by Color Schemes include:
31
30
- Search matches
32
-
- Line Coverage sections
31
+
- Line coverage sections
33
32
- Tooltips
34
33
- Notifications
35
34
- Breadcrumbs
36
35
- Gutter modified lines
37
36
- ...
38
37
39
-
However, up until 2019.1 scrollbars were still controlled by the UI Theme.
40
-
This was fine but if the color scheme was using a dark purple shade, for instance, why would the scrollbar still _Darcula Gray_ based?
38
+
Prior to version 2019.1, scrollbars were strictly controlled by the UI Theme. This often led to visual inconsistencies; for example, a dark purple color scheme might still display standard "Darcula Gray" scrollbars.
41
39
42
-
As a result, they refactored the scrollbars, allowing color scheme designers to control the color and opacity of the scrollbars when their scheme is applied.
43
-
However, this setting is nowhere to be found as of today!
44
-
The only way to change the _Scrollbar_ colors was from the XML file directly.
45
-
46
-
While this is bound to happen sooner or later, in the meantime the plugin adds a new section in the _Color Scheme Settings_ to allow tuning these colors,
47
-
independently of the UI Theme being used.
40
+
To address this, JetBrains refactored scrollbars to allow color scheme designers to define their own colors and opacity. However, as of now, these settings are not exposed in the standard IDE settings and can typically only be modified by editing the color scheme's XML file directly.
48
41
42
+
The Material Theme UI plugin bridges this gap by adding a dedicated section in the **Color Scheme Settings**, allowing you to tune scrollbar colors independently of your current UI Theme.
49
43
50
44
----
51
-
## Scrollbar colors
52
45
53
-
You can find this section under `Settings > Editor > Color Scheme > Scrollbars`.
54
-
Since this is a color scheme based setting, each color scheme has its own, with a default value of gray if not defined.
46
+
## Scrollbar Colors
55
47
56
-
{% include figure.html content="/screens/scrollbarSettings.png" caption="Scrollbar Settings" %}
48
+
You can access these settings under `Settings/Preferences > Editor > Color Scheme > Scrollbars`. Since these settings are tied to the color scheme, each scheme can have its own unique configuration. If no specific colors are defined, the IDE defaults to a standard gray.
57
49
58
-
By default, in the provided themes all the scrollbar properties have the same value.
59
-
But you can easily specify a different border color, or a different color when hovered.
50
+
{% include figure.html content="/screens/scrollbars/scrollbarSettings.png" caption="Scrollbar Settings" %}
60
51
61
-
### System Scrolling Settings
52
+
By default, the Material Theme's included schemes use consistent values for all scrollbar properties. However, you can easily customize specific elements, such as the border color or the color used when the scrollbar is hovered.
62
53
63
-
In macOS systems, the scrollbar colors are highly dependent on the _System scrollbar settings_:
54
+
###macOS System Scrolling Settings
64
55
65
-
{% include figure.html content="/screens/macScrollSettings.png" caption="Scrollbar Settings macOS" %}
56
+
On macOS, scrollbar appearance is heavily influenced by system-level settings found in `System Settings > Appearance`:
66
57
67
-
- If you decide to go with "_Always_", then the `Transparent` values have no effect.
68
-
- But, should you select the option to display the scrollbar only when scrolling, then only the `Transparent` settings are relevant.
58
+
{% include figure.html content="/screens/scrollbars/macScrollSettings.png" caption="macOS Scrollbar Settings" %}
69
59
60
+
-**Always**: If the system is set to always show scrollbars, any `Transparent` color settings will have no effect.
61
+
-**When scrolling**: If scrollbars are only shown during interaction, only the `Transparent` settings in the IDE will be applied.
70
62
71
-
Be aware, that modifying these values from the prebundled color schemes results in the color schemes being copied,
72
-
so color scheme updates would not be reflected unless you decide to `Restore Defaults`.
63
+
**Note**: Modifying these values in a pre-bundled color scheme will create a local copy of that scheme. Consequently, future updates to the original scheme will not be reflected unless you select `Restore Defaults`.
73
64
{:class='card-panel warn'}
74
65
75
66
----
67
+
76
68
## FAQ
77
69
78
-
**Q**: **I've set the `Accent Scrollbars` setting off, but my scrollbar is still blue/orange/whatever!**
70
+
**Q: I've disabled the "Accent Scrollbars" setting, but my scrollbars are still colored!**
79
71
80
-
**A**: The `Accent Scrollbars` and `Transparent Scrollbars` feature control the appearance of the IDE Scrollbars, not the editor scrollbars.
81
-
For the editor scrollbars, unfortunately, the only way to do so is to use this _Color Scheme Panel_.
72
+
**A:** The `Accent Scrollbars` and `Transparent Scrollbars` features control the appearance of **IDE-wide scrollbars** (e.g., in tool windows or lists). They do not affect the **editor scrollbars**. To customize the editor's scrollbars, you must use the **Color Scheme** settings described above.
82
73
83
-
**Q**: **I've uninstalled the theme, but the scrollbar colors persist!**
74
+
**Q: I've uninstalled the plugin, but the scrollbar colors haven't reverted!**
84
75
85
-
**A**: Since these colors are color scheme based, removing the plugin doesn't revert them back, just like with the [File Status Colors](/docs/configuration/file-status-colors).
86
-
The only way to do so would be to restore the color scheme.
76
+
**A:** Because these settings are saved within your active Color Scheme, removing the plugin does not automatically reset them—similar to how [File Status Colors](/docs/configuration/file-status-colors) behave. To return to the original look, you will need to manually restore your color scheme's default settings.
0 commit comments