Отсутствует представление iFrame для Javadocs JDK 11+
Пользуюсь JavaDocs для JDK 11
Но я заметил, что представление iFrames больше не доступно. Я огляделся, но не вижу никаких подробностей о том, почему это было сделано, и какие есть альтернативы, если таковые имеются? Кто-нибудь может предоставить более подробную информацию?
Просмотр для JDK 10
Просмотр для JDK 11
Ответы 2
Если у кого-то еще есть такой же запрос, фреймы больше не генерируются по умолчанию.
Это описано в JDK-8202961
In times past, to allow for navigation within API documentation, the standard doclet presented indexes in frames on the left side of the window to allow classes, packages and (more recently) modules to be selected for display in the main body of the window.
More recently, the doclet now supports a "search" feature, which provides a more versatile way of finding items to view. Separately, the doclet is moving towards using HTML 5 (only), and the basic support for frames in HTML 5 is less than it was in HTML 4.
и JDK-8187794 среди других
Update the javadoc/doclet to generate no frames as a default. A warning should be generated if "--frames" option is specified to generate frames. The support for frames will be removed from a future release.
Кажется, что если вы действительно хотите использовать фреймы, вы можете сгенерировать свои собственные из JDK src и получить предупреждение, но в какой-то момент оно будет полностью удалено.
Таким образом, привыкните к функции поиска, кадры javadocs на пути к выходу!
Что ж, это не обязательно должны быть фреймы, но какая-то другая форма дерева навигации как, предыдущие фреймы были бы хороши. Ссылка на функцию поиска не очень полезна, поскольку просмотр навигации полностью отличается от поиска определенного термина ... Мне не очень нравится, в каком направлении развивается Java в данный момент.
Вы все еще можете использовать кнопку «Все классы» в верхнем левом углу, которая показывает старый список классов.
@radlan Они по-прежнему предоставляют вариант дерева.
Я согласен, что это изменение нежелательно. Я широко использовал функцию фреймов и обнаружил, что это очень полезный способ навигации по API. Если они хотели удалить эту функцию, им следовало найти другой механизм в HTML 4 или 5, чтобы обеспечить ту же функциональность.
Проблема с «поиском» в том, что вы можете искать только то, что вам уже известно. Oracle упускает из виду, что иногда целью навигации по пакетам является изучение и обнаружение API.
> Вы все еще можете использовать кнопку «Все классы» ... Даже этого, похоже, нет в Java 12+.
Это похоже на то, как Oracle хочет убить Java, намеренно усложняя ее использование.
Фреймы отсутствуют, навигация есть: JANITOR - Навигация по Java API - единственное спасение: Вставляет дерево навигации для модулей, пакетов и типов (интерфейсы, классы, перечисления, исключения, ошибки, аннотации) на страницы документации Javadoc Java 11+..
@lscoughlin Тебе нравится это в моем ответе здесь?
@radlan "некоторая другая форма дерева навигации, такая как предыдущие кадры, было бы неплохо" - Ну вот!
@ atom88 "они должны были найти другой механизм" - Я нашел (ред) один.
@Gustavo «иногда навигация по пакетам - это поиск и изучение API» - Ну вот!
Абсолютно согласен, я использовал представление фреймов постоянно, чтобы просмотреть, что предлагают конкретные пакеты. Это фундаментальный стиль просмотра. Это происходит повсеместно в веб-приложениях - вместо навигации появляется поле поиска, а это значит, что вы должны заранее знать, что ищете!
Такое изменение заставляет меня чувствовать, что этот оракул хочет внести ненужные изменения и сделать его отличным от Sun.
Я просматриваю документы API, перетаскивая полосу прокрутки для классов iframe. Обычно я знаю, какой класс мне нужен, поэтому его легко найти в списке, используя только мышь. Теперь мне нужно ввести имя в поле. Ужасный.
эта документация по java API ужасна, что очень плохо, потому что мне нравится java, потому что у нее такая читаемая документация. Я не думаю, что смогу эффективно ориентироваться в Java API в его нынешнем виде. Как мне создать автономную документацию с удобным для пользователя представлением Frames.
Значит, API сейчас нельзя обнаружить? Целью обзора фреймов было увидеть, что доступно. Поиск - это то, что вы знаете, для этого я даже не выхожу из IDE.
Я создал JANITOR - Навигация по Java API - единственное спасение, который:
Inserts a navigation tree for modules, packages and types (interfaces, classes, enums, exceptions, errors, annotations) into the Javadoc pages of Java 11+.
Я так ненавижу это.