缺少Javadocs JDK 11的iFrame视图

mut*_*nUp 40 java javadoc java-11 java-12

我一直在使用JavaDocs for JDK 11

但我注意到iFrames视图似乎不再可用.我环顾四周,但看不出有关为什么要这样做的任何细节,以及有什么替代方案?谁能提供更多细节?

查看JDK 10 JDK 10的JavaDocs

查看JDK 11 JDK 11的JavaDocs

mut*_*nUp 38

如果其他人具有相同的查询,则默认情况下不再生成帧.

这在JDK-8202961中有所介绍

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

最近,doclet支持"搜索"功能,该功能提供了一种查找项目的更通用方式.另外,doclet正朝着使用HTML 5(仅)的方向发展,HTML 5中对框架的基本支持比HTML 4中的要少.

JDK-8187794

更新javadoc/doclet以不生成任何帧作为默认值.如果指定"--frames"选项以生成帧,则应生成警告.将从以后的版本中删除对框架的支持.

似乎如果你真的想要使用框架,你可以从JDK src生成自己的框架并体验警告,但这将在某些时候完全删除.

总而言之,习惯了搜索功能,框架javadocs正在出路!

  • 我非常讨厌这个. (60认同)
  • 好吧,它不一定是框架,但是其他形式的导航树_like_以前的框架会很好.参考搜索功能并不是很有用,因为浏览导航与搜索特定术语完全不同......它并不像Java目前所处的那样. (20认同)
  • 完全同意,我一直使用框架视图来浏览特定的软件包提供的内容。这是一种基本的浏览方式。这种情况在各地的网络应用程序中都在发生——用搜索框取代导航,这意味着您必须提前知道您要寻找什么! (8认同)
  • “搜索”的问题在于,您只能搜索已经知道的内容。Oracle错过了有时浏览软件包的目的是探索和发现API。 (5认同)
  • 我同意,这种更改是不必要的。我广泛使用了框架功能,并发现它是浏览API的非常有用的方法。如果他们想删除此功能,则应该在HTML 4或5中找到另一种机制来提供相同的功能。 (4认同)
  • > 您仍然可以使用“所有类”按钮...即使在 Java 12+ 中这似乎也消失了。 (4认同)
  • 这就像 Oracle 想要通过故意让 java 更难使用来杀死它一样。 (4认同)
  • 这种改变让我感觉oracle想要做出不必要的改变,让它与Sun不同。 (3认同)
  • 我通过拖动类 iframe 的滚动条来导航 API 文档。我通常知道我要上什么课,因此只需使用鼠标操作即可轻松在列表中找到。现在我必须在框中输入名称。糟糕的。 (3认同)
  • 您仍然可以使用左上角的“所有类别”按钮,该按钮显示旧的类别列表。 (2认同)
  • 那么API现在是不可发现的吗?框架视图的目的是查看可用的内容。搜索是为了搜索你所知道的东西,为此我什至没有离开 IDE。 (2认同)
  • 这绝对是扼杀我学习java类库的主要方式。完全让我生气的是它不再被发现了。 (2认同)

Ger*_*ica 12

我创建了JANITOR – Java API 导航是唯一的救援,它:

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

JANITOR – Java API 导航是唯一的救星