Javadocs JDK 11 + 缺少 iFrame 视图

我一直在用 用于 JDK 11的 JavaDocs

但是我注意到 iFrames 视图似乎不再可用。 我四处看了看,但是没有看到任何关于为什么要这样做的细节,以及如果有其他选择的话会是什么?有人能提供更多细节吗?

JDK 10的视图

JavaDocs for JDK 10

JDK 11的视图

JavaDocs for JDK 11

7461 次浏览

如果其他任何人有相同的查询,则默认不再生成框架。

这是 JDK-8202961的内容

在过去,为了允许在 API 文档中导航,标准 doclet 在窗口左侧的框架中显示索引,以允许选择类、包和(最近)模块在窗口的主体中显示。

最近,doclet 现在支持“搜索”特性,该特性提供了一种更通用的查找项目的方法。另外,doclet 正在向使用 HTML5(仅)的方向发展,而且 HTML5对框架的基本支持比 HTML4少。

以及 JDK-8187794

更新 javadoc/doclet 以不生成默认帧。如果为生成帧指定了“—— frame”选项,则应该生成一个警告。对帧的支持将从未来的版本中删除。

看起来,如果您真的想使用框架,您可以从 JDK src 生成自己的框架并体验这个警告,但是在某个时候这将被完全删除。

总之,习惯了搜索功能,框架 javadocs 就要出来了

我创建了 JANITOR-JavaAPI 导航是唯一的救援:

在 Java11 + 的 Javadoc 页面中插入模块、包和类型(接口、类、枚举、异常、错误和注释)的导航树。

JANITOR – Java API Navigation Is The Only Rescue

如果您更喜欢 Java10以及更早的 API 文档布局,使用 HTML iframe,那么您可能需要查看以下内容: https://github.com/climber09/Javadoc-Frames-Generator。这是一项正在进行的工作,所以我欢迎任何反馈。