Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minimap: Render git status decorations #20934

alexdima opened this issue Feb 20, 2017 · 20 comments

Minimap: Render git status decorations #20934

alexdima opened this issue Feb 20, 2017 · 20 comments


Copy link

@alexdima alexdima commented Feb 20, 2017

Some ideas:

  • editor cursor
  • editor selection
  • change annotations (i.e. git status)
  • find matches

Here is a good mock-up from @jfcartier here:


And one from @octref here:


@alexdima alexdima self-assigned this Feb 20, 2017
Copy link

@octref octref commented Feb 20, 2017

Git status could also be helpful.

Copy link

@CoenraadS CoenraadS commented Feb 20, 2017

Visual Studio also displays function scope (bubbles) & nesting (lines), which I use a lot.


Since the minimap is character based I'm not sure how this would be implemented though. Perhaps just alternating background colors.

Copy link

@Tekbr Tekbr commented Feb 21, 2017

-- Sorry for the English, I used Google Translator --

@alexandrudima Sorry if it's repetitive. Would any of the options below be related to the options it showed above? If not, these options could enter as a feature request or even as an extension (sorry for the English):

1- Find and replace
2- Highlight selected
3- Cursor line
4- Selection
5- git-diff - I think it's your fourth choice, right? 😄
6- Bookmarks - I do not know if extension that exists is able to use the resources for the minimap. #54

Copy link

@alefragnani alefragnani commented Feb 21, 2017

Based on @Tekbr request on my Bookmarks extension, I think the decorator API should be expanded to support minimap. Something similar to OverviewRulerLane and overviewRulerColor in DecorationRenderOptions. Doing so, any extension that supports the decorator API would work automatically.

By the way, after turning on Minimap I keep thinking if the Ruler is still necessary. I would say no if the Minimap supported mouse scroll and the decorator API was merged 😄

Copy link

@MartinSGill MartinSGill commented Feb 21, 2017

I agree with @alefragnani that I think the ruler is no longer required once many/most of the suggestions in this issue are implemented.

My feeling is that the ruler is essentially just a minimalist version of the mini-map and that both are actually the same thing, just displaying differing amounts of information.

Copy link

@druellan druellan commented Mar 2, 2017

@MartinSGill those are my thought exactly. My feeling is that the minimap should integrate out-of-the-box everything VSCode provides on its core, including highlights, git integration, etc. And at that point its going to be a more verbose version of the enhanced scrollbar, so, you can disable that if you want.

Copy link

@brandalorian brandalorian commented Mar 3, 2017

At a minimum it would be nice to get all the features that currently exist in the skinny "git" sidebar integrated into the minimap, and to add a setting to hide the skinny "git" sidebar if you use the minimap. Right now its kind of like there are 2 mini-maps. The original one that is functional, and the new minimap that only shows a high-level view of your code.
screen shot 2017-03-03 at 7 31 48 am

@rmunn rmunn mentioned this issue Mar 9, 2017
2 of 3 tasks complete
Copy link

@mika76 mika76 commented Mar 9, 2017

I actually think it would be cool those show both next to each other (as they are now) but just sync their scrolls (currently the minimap shows the whole viewport while the scroll bard has a tiny little "grip") and they do not seem to scroll at the same rate (scrollbar and it's decorators show the whole file in the whole length while the minimap scrolls if a file is long enough)

I like the way the Visual Studio minimap works where the decorators are separate from the code - since it's much easier to spot a coloured block on the side (for example when doing a find) then it is to see a highlight in already-syntax-highlighted code)

But I do not see why we have to copy everything Atom or Sublime does...

Copy link
Member Author

@alexdima alexdima commented Mar 9, 2017

@mika76 This has already been proposed in #21849

I summarised the discussions regarding minimap geometry we had within the team in #21849 (comment)

Copy link

@mika76 mika76 commented Mar 9, 2017

@alexandrudima Ah I see - thanks for the notification. Could I propose something then? If there are decorators for the code in the minimap (find for example) could the minimap go into grayscale more or something? I find in Atom and Sublime, when I want to quickly see a highlight in the minimap it always get's lost in the syntax coloring. This is the reason I like the points being on the side of the actual code in VS2015...

Copy link

@bjunix bjunix commented May 4, 2017

Would also like to see linter errors/warnings:

screen shot 2017-05-04 at 10 42 32

By the way, great job on the minimap. Love this feature. Thanks for the work you put into it!

Copy link

@ak-hpc ak-hpc commented Jul 11, 2017

To be useful, minimap has to always show current cursor line and current viewport. Looks like current viewport showing is already implemented in insiders channel, but cursor line is not.

You can use Visual Studio minimap as a reference:
(VS 2013)

It replaces plain slider (there is no other slider when minimap is enabled), and always contains whole document without inner scrolling. It also shows errors/warnings/find results/etc.

@ghiscoding ghiscoding mentioned this issue Aug 9, 2017
45 of 53 tasks complete
@alexdima alexdima removed their assignment Nov 24, 2017
Copy link

@Kroc Kroc commented Jun 2, 2018

I only have a 1366x768 screen on my laptop so horizontal space is tight and I'd like to see the ability to combine / replace the scrollbar with the minimap since they both effectively solve the same navigation problem.

Copy link

@bcbane bcbane commented Jul 27, 2018

Oh please add this in! I would like to second adding in Highlight selected on the minimap and cursor line

Copy link

@simeyla simeyla commented Mar 9, 2019

I wish it had more options to show / hide. eg.

  • Show only when file has errors
  • Show only when Ctrl key held down for 1 second
  • Show only when mouse hovers over the area it would be shown in
Copy link

@Colengms Colengms commented May 3, 2019

Adding a note here. I think my issue ( #73140 ) may have been incorrectly duped to this one. It is a request for the minimap to reflect text decorators that were applied in the editor, just as the textmate colors are reflected. We would like to do our own colorization, but currently the result are not reflected in the minimap.

Copy link

@RMacfarlane RMacfarlane commented Oct 10, 2019

As of the latest release (1.39), selection and find matches are shown in the minimap. I'd like to scope this issue down to something specific for easier tracking, so I'm going to repurpose this for git status annotation decorations.

There are some other good ideas in this thread, I think most of them have been covered by other issues:

There didn't seem to be an existing issue tracking error/warning decorations specifically, so I created a new issue for that: #82291

@RMacfarlane RMacfarlane changed the title Minimap: Render more than characters inside the minimap Minimap: Render git status decorations Oct 10, 2019
@RMacfarlane RMacfarlane self-assigned this Nov 5, 2019
@RMacfarlane RMacfarlane modified the milestones: Backlog, October 2019 Nov 5, 2019
@kieferrm kieferrm mentioned this issue Nov 11, 2019
50 of 68 tasks complete
Copy link

@dlong500 dlong500 commented Dec 2, 2019

It looks like a recent insider build enabled linter warnings/errors in the minimap. That's great for those that want it, but ideally a way to hide them would be nice (at least for linter warnings). Some files have a lot of warnings and they clutter up the minimap. Is that possible?

Copy link

@RMacfarlane RMacfarlane commented Dec 2, 2019

@dlong500 Currently there isn't a setting for this, but you can change the color of the decorations to match the editor background so that they're not visable:

"workbench.colorCustomizations": {
	"minimap.errorHighlight": "#1e1e1e",
        "minimap.warningHighlight": "#1e1e1e",

You can check your current color theme colors by running the Developer: Generate Color Theme from Current Settings command

@RMacfarlane RMacfarlane mentioned this issue Dec 2, 2019
3 of 3 tasks complete
Copy link

@dlong500 dlong500 commented Dec 2, 2019

I was about to say this didn't seem to work, but I searched the repo and it looks like you just added these options about 20 minutes ago? I'll have to wait until the next insider release. Thanks!

@vscodebot vscodebot bot locked and limited conversation to collaborators Dec 20, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet