JDK 11+中Javadocs缺少iFrame视图

83

我一直在使用 JDK 11的JavaDocs

但是我注意到iFrames视图似乎不再可用。我搜索了一下,但没有找到关于这个问题为何被处理以及是否有其他的替代方案的任何细节。能否有人提供更多详细信息?

JDK 10的视图

JDK 10的JavaDocs

JDK 11的视图

JDK 11的JavaDocs

3个回答

69
如果其他人有同样的问题,框架已不再是默认生成的。
这在JDK-8202961中有所涵盖。
过去为了允许在API文档中进行导航,标准文档生成器会在窗口的左侧使用框架索引,以便选择要在窗口主体中显示的类、包和(最近)模块。最近,该文档生成器现在支持“搜索”功能,提供了一种更灵活的查找项目的方式。另外,文档生成器正在向仅使用HTML 5迁移,并且HTML 5对框架的基本支持不及HTML 4。
以及JDK-8187794等等
将javadoc/doclet更新为默认不生成框架,如果指定“—frames”选项来生成框架,则应生成警告。在将来的版本中,将删除对框架的支持。
看起来,如果您真的想使用框架,可以从JDK src中生成自己的框架并体验警告,但这将在某个时候完全删除。
总之,熟悉搜索功能,因为框架式的javadoc即将退出历史舞台!

141
我非常讨厌这个。 - lscoughlin
60
嗯,它不一定要是框架,但是像以前的框架那样的其他形式的导航树会很好。提到搜索功能并不是很有帮助,因为浏览导航与搜索特定术语完全不同...我真的不喜欢Java目前的发展方向。 - radlan
28
我同意,这种改变是不希望的。我广泛使用了框架功能,并发现它是一种非常有用的浏览API的方式。如果他们想要删除该功能,他们应该在HTML 4或5中找到另一种机制来提供相同的功能。 - atom88
41
“搜索”的问题在于你只能搜索自己已经知道的内容。Oracle 没有理解到,有时候导航包的目的是为了探索和发现 API。 - Gustavo
16
完全同意,我一直使用“框架视图”来浏览特定软件包提供的内容。这是一种基本的浏览方式。这种情况在许多网络应用程序中都发生了——用搜索框取代导航,这意味着您必须预先知道您要查找的内容! - Sam Hokin
显示剩余18条评论

20

4

1
虽然此链接可能回答了问题,但最好在此处包含答案的关键部分并提供链接以供参考。如果链接页面发生更改,则仅有链接的答案可能会失效。 - 来自审核 - Dom
1
不幸的是,Phantomjs库在2018年被其开发者放弃了,所以尽管您的项目很有趣,但我不能在我的组织中推荐使用它。 - Ichiro Furusato
Frames-Generator 工作得非常好。@Ichiro Furusato:不用担心被遗弃的 Phantomjs 库。它只需要在生成时使用一次,可以在组织外的任何计算机上进行。一旦生成了新的 javadoc,就不再需要 Phantomjs 或 Frames-Generator,只需要生成的 HTML 文件即可。 - Johanna

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接