Swagger UI opens link in new page

[dvarrazzo]

The problem comes with the pages generated by FastAPI: advices about how to customise it are welcome.

• Swagger-UI version: probably 3.49.0 (whatever currently served by https://cdn.jsdelivr.net/npm/swagger-ui-dist@3/swagger-ui-bundle.js)

All links, including intra-page ones, are rendered with target="_blank". This is a major usability issue and make documentation very hard to use.

[hkosova]

Duplicate of #3473.

[dvarrazzo]

Uhm... I am somewhat confident that a few months ago this wasn't happening. Any chance of that or I'm wrong?

[hkosova]

It's not a recent change, it's been a few years.

Here are some related developer comments from #3498 (comment):

As for external links - we used to open them in the same tab, but due to (very) popular demand, implemented the opening in a new tab. It makes sense - if you navigate away from the documentation every time, it can break the flow.

[...] #3473 is talking about something a bit different - local links should not open in new tabs - that is, other anchors in the same instance of swagger-ui, should just jump to those anchors. However, I'm not sure our markdown parser generates those anchors in the first place, making this a harder problem to solve.

So external links having target="_blank" is by design, and the issue with internal anchor links is tracked in #3473.