Skip to content

Commit fd697dc

Browse files
committed
Update "Scrollbars" documentation with revised descriptions, improved structure, and new visuals. Rename and reorganize related image files. Remove outdated screenshots.
1 parent da90bf9 commit fd697dc

11 files changed

Lines changed: 21 additions & 31 deletions

docs/configuration/scrollbars.md

Lines changed: 21 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -24,63 +24,53 @@ Customize the editor scrollbars from the Color Scheme.
2424

2525
## Introduction
2626

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.
2928

30-
Such examples are:
29+
Examples of elements controlled by Color Schemes include:
3130
- Search matches
32-
- Line Coverage sections
31+
- Line coverage sections
3332
- Tooltips
3433
- Notifications
3534
- Breadcrumbs
3635
- Gutter modified lines
3736
- ...
3837

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.
4139

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.
4841

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.
4943

5044
----
51-
## Scrollbar colors
5245

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
5547

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.
5749

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" %}
6051

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.
6253

63-
In macOS systems, the scrollbar colors are highly dependent on the _System scrollbar settings_:
54+
### macOS System Scrolling Settings
6455

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`:
6657

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" %}
6959

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.
7062

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`.
7364
{:class='card-panel warn'}
7465

7566
----
67+
7668
## FAQ
7769

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!**
7971

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.
8273

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!**
8475

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.

img/screens/boldDirectories.png

-17.9 KB
Binary file not shown.
-159 KB
Binary file not shown.
-123 KB
Binary file not shown.

img/screens/fileColors.png

-171 KB
Binary file not shown.
290 KB
Loading
File renamed without changes.
250 KB
Loading
File renamed without changes.

0 commit comments

Comments
 (0)