Outline: support for //#region fold regions

[julien-c]

in conjunction with hierarchical support in outlines.

Here's how Xcode is doing it:

[vscodebot]

(Experimental duplicate detection)
Thanks for submitting this issue. Please also check if it is already covered by an existing one, like:

• [folding] select line with folding should include folded range (#51232)

[aeschli]

Each language support defines what document symbols it returns and these are shown in the outline.

What language do you want the feature for?

[julien-c]

Typescript, but any way of exposing a "section" symbol from a document would work, I guess.

[mjbvz]

@jrieken @aeschli I don't think this should be language specific. With folding providers and symbol providers, we already have both regions and which symbols they contain. If we want to support this feature, we should use these to construct the outline

[aeschli]

The purpose of document symbols is very spcifically to provide the symbols for the quick outline as well as the new outline. Why trying to be smart on our side and merge in the two providers with very specific purposes. This just asks for trouble.
The language provider knows much better what document symbols are meaningful to the user.

Also, the folding provider doesn't define a name that could be used as a symbol name, has a separate lifecycle...

[jrieken]

Why trying to be smart on our side and merge in the two providers with very specific purposes. This just asks for trouble.

Well, you don't need to merge but you can simply add your own tree. Similar to the unit-test-navigator https://marketplace.visualstudio.com/items?itemName=roblourens.unittest-navigate. However, that should and easily can be done as extension. It's the combination of an API command and the registration of a document symbol provider. That will give you two separate trees and one flat view in the quick outline.

If you want regions/pragmas be intermixed with document symbols you need to do this per language brain/extension.

@julien-c What is it you are looking for?

[jrieken]

Giving this back to you @mjbvz. I think this should come from language extension themselves because only then the hierarchy looks nice, e.g. not multiple root nodes per extensions/scope and only with that we are sure things are correct.

[david50407]

Is there any extension support showing Typescript region in Outline?

[fuzzy76]

Most of the discussion here is probably outdated. Regions is a cross-language thing now AFAIK, so the data is available?

[qiulang]

Hi, what is the progress of feature request? I find WebStorm also supports this nicely while all the extensions for region on marketplace look quite shabby.

[vscodenpa]

We closed this issue because we don't plan to address it in the foreseeable future. If you disagree and feel that this issue is crucial: we are happy to listen and to reconsider.

If you wonder what we are up to, please see our roadmap and issue reporting guidelines.

Thanks for your understanding, and happy coding!

[fuzzy76]

Here it is then: please reconsider.

[danqdinh]

Yes please, vscode team, consider, long code files need regions to organise groups of functions/methods

[insin]

For anyone else still looking for this feature, the Region Viewer Extension is good if you use regions primarily to navigate and fold large files and you're not really bothered about having the rest of the Outline contents inside the region:

https://github.com/berabue/vscode-region-viewer

[JoElfner]

Any news on this? This is - imho - a very important feature for usability.