Minimap

[JosephTLyons]

[exalted]

FWIW, I am strongly against this 👎

[aexvir]

I'm also not a fan, it brings me zero value and it's distracting and takes space
but as long as it's optional I don't see why it couldn't be added
there is definitely people who likes it

[OldManFroggy]

best way I have seen a minimap implemented is -> inside a scroll bar, I think VSCode does it this way and as such takes up no extra UI space.

also a minimap should only show only selections, and lsp errors,warnings only in the minimap, changed lines of code (aka. git status) -> which makes minimap very functional and not just lipstick on a pig.

[aexvir]

@scott-ling the default vscode minimap? it works nothing like that for me 🤔 am I missing some config?
the only editor I recall showing the errors and warnings on the scrollbar is the intellij platform one but that's not really the minimap being discussed here; and usually git status indicators are on the left gutter, not on the minimap either

would you mind showing how the minimap looks for you on vscode? 😅
I'm curious if I have been missing some nice fancy features all this time 😆

[OldManFroggy]

heres a little pic, just opened up a .bashrc and searched for an = sign, and you can see in the scrollbar there are all lines showing.

…

On Jul 14 2022, at 8:22 pm, Alex Viscreanu ***@***.***> wrote: @scott-ling (https://github.com/scott-ling) the default vscode minimap? it works nothing like that for me 🤔 am I missing some config? the only editor I recall showing the errors and warnings on the scrollbar is the intellij platform one but that's not really the minimap being discussed here; and usually git status indicators are on the left gutter, not on the minimap either would you mind showing how the minimap looks for you on vscode? 😅 I'm curious if I have been missing some nice fancy features all this time 😆 — Reply to this email directly, view it on GitHub (https://github.com/zed-industries/feedback/issues/263#issuecomment-1184812013), or unsubscribe (https://github.com/notifications/unsubscribe-auth/ATXWUNSP5KMPNUACILT3CSLVUBSGTANCNFSM53CW47CQ). You are receiving this because you were mentioned.

[aexvir]

can't see anything 😅 did the screenshot get attached?
but alright, I've reenabled it on vscode and I can indeed see the selections or search results in the minimap
I don't think this is very useful for me, especially seeing how much space the minimap takes
but yeah, I get your point

[OldManFroggy]

never said I was intelligent, seems github email drops images - ps. this is VSCode Insiders but think feature is on main branch also.

See its in scroll bar -> not the mini map view setting which I never use, as stated above wastes soo much space :)

[aexvir]

oh, hold up, that's something different... that's the scrollbar itself, which I have butchered with custom css 🤣
yep, this is what I know from intellij based editors, but I wasn't aware vscode also had it
I turned off scrollbars looong time ago 😅

yeah, this is definitely more useful 👍🏻

[OldManFroggy]

yeah, minimaps sux, minimap like features in scroll bar, awesome use of space

…

On Jul 14 2022, at 8:56 pm, Alex Viscreanu ***@***.***> wrote: oh, hold up, that's something different... that's the scrollbar itself, which I have butchered with custom css 🤣 yep, this is what I know from intellij based editors, but I wasn't aware vscode also had it I turned off scrollbars looong time ago 😅 yeah, this is definitely more useful 👍🏻 — Reply to this email directly, view it on GitHub (https://github.com/zed-industries/feedback/issues/263#issuecomment-1184841051), or unsubscribe (https://github.com/notifications/unsubscribe-auth/ATXWUNQC3EHVLBCD3R4KLU3VUBWF5ANCNFSM53CW47CQ). You are receiving this because you were mentioned.

[JosephTLyons]

I'm dyslexic (being a dyslexic dev is a weird thing, but that's another story), so I often recognize code by the shape of it - which is where the minimap becomes useful for me. I've never cared for the decorators in the scrollbar (JetBrains' IDEs) because I can't see the code's shape there, which is important to me.

[uicowboy]

I think the minimap by itself is not very useful. However, it's actually really nice when it shows red/yellow lines for ESLint and/or TypeScript errors/warnings throughout the entire file, allowing you to quickly click on that area of the minimap and scrolling you down to where the issue is.

[heyallan]

I also recognize code by it's shape. It's super useful. But I prefer seeing an outline of the document (like a table of contents). It gives me shape but also meaning in less space.

The breadcrumb feature already creates an outline, but only line by line, which is weird because if I am already at that line I already know where I am.

A document outline (as a form of minimap) would be useful for large documents.

Also, hints in the scrollbar are immediately useful.

[JosephTLyons]

@heyallan,

You're probably already aware of this, but in case you haven't seen this, we do have a search buffer symbols action that gives you a modal popup where you can see the overview of the current file's symbols. You can then filter down to what you want and be taken to that point in the code.

[heyallan]

@JosephTLyons Exactly. The functionality is already there. I just would like to have it permanently open on the side as a form of minimap.

[natempv]

fwiw I love the minimap for giving the code a shape and body, helps me navigate it by feel, like a few people have mentioned already. like i know where things are from the topology of the thing, like it's a kaiju or a battleship. i've come to understand this is atypical but

also because I'll occasionally annotate my code with huge ascii/ansi art, kind of like xcode's //MARK comments but I usually just use figlet

[tjkohli]

+1 on this request. It really helps to scan & pinpoint getting to the correct code section especially in longer files.

[ElhamAryanpur]

I would really love this as well, it helps get birdeye view of the code and locate blocks easily. +1

[insunaa]

A minimap is also useful when you have a multi-monitor setup and need to do a big jump-scroll. Currently with zed it's a fight to even hit the tiny scroll-bar handle when your document is a few thousand lines of code. 4px high and 10px wide on a 1440p monitor and if you miss it you either mark random stuff in your document, click into another application on your other monitor, jump to a random location in code or if you're truly unlucky hit the window resizer.

[pyromaniac]

I'm all for the minimap addition, this is an essential tool and helps a lot with code navigation and understanding. Please consider implementing it.

[jakobwildrain-si]

Is there a way to write it as an extension?
I love Zed and minimap is the only feature that I'm REALLY missing.

I would learn Rust to be able to write a minimap for Zed, but I don't think the way I would implement it would work for other people, so I'd rather write it as an extension, so if people don't like it they can pick another implementation of it.

[s-m-e]

For many reasons stated above (for me navigating large quantities of code, seeing where marked words and symbols show up, where text got replaced, where linters show issues etc) I am really missing this feature. It has been a great help to me in past. A GPU-accelerated map would open the door to a ton of cool use cases. If not implemented, I'd say it's a missed opportunity folks.

[Felipe-9]

I also use the #MARK and ascii banners features extensively on my documents, its very present on my workflow and i miss it very much.

[matthieuHenocque]

Came back here to share a bit of personal experience where the Minimap has been incredibly useful with the hope it will convince the Zed team to implement it.

We recently adopted Airbnb coding style at my company so I had to refactor huge JavaScript controllers from a legacy codebase. I used the Minimap's holistic point of view to evaluate the time needed to solve all of the linter's errors and warnings.

Regarding linters errors, it would be nice if there was a visual indicator of errors for things that are missing (like a semicolon) in the buffer. Just sayin'.

[mocenigo]

The argument is simple: Minimap is such a common feature nowadays — there are even some editors running in a terminal with a minimap — that it is simply needed to guarantee an editor’s wide adoption. And one of zed’s goals is to be widely adopted.

This, and the ability to expose commands and command sequences in sidebar lists (like VScode), and two way sync with SyncTeX.

The latter could be achieved with proper scripting. Or a wider API, which then could be used by the extensions.

[SomeoneToIgnore]

There's 43 participants that get useless flood of e-mail and other notifications due to the new postings, hence I've locked the issue and urge people interested in the feature to submit PRs on the topic instead of all this above.

Unfortunately, GH will prevent adding 👍 emojis for this too, but it's quite clear that the feature is wanted and in demand, it's just someone has to get the time to implement it.

I am not sure exactly how to implement this, but feel that all the bits are ready.
Here's the path I'd try:

• if ones opens any editor and zooms out to the end (e.g. by holding cmd-- on mac), there will appear something that looks like a mini map already:

• gpui allows absolute positioning of elements and various overflows, so we can take the buffer and wrap it into a new editor, enforce "max zoom out" property for it and absolute position it over everything in the top right corner modulo header and other menus above.
  It feels that scrollbar and minimap should start at the same point above, and maybe even be of the same length?

• we might need to somehow ensure it's semi-transparent but it's not very needed for the first prototype if the whole minimap is disabled by default and can be enabled with a setting.
  We should also make that new editor read-only, disable copilot suggestions, etc. and follow events of the "original" editor — so we can reflect selections and, maybe later, visible area border display.

• Also, we need to override click event handlers to scroll the original editor (and the minimap editor) if the minimap editor is clicked, same way the scrollbar does it.

• Click through it and otherwise use it to ensure that it works normally and submit a PR.