JDK-8248566 : Make API docs more usable on mobile browsers
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2020-06-30
  • Updated: 2021-02-13
  • Resolved: 2020-11-27
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 16
16 b27Fixed
Related Reports
Relates :  
Sub Tasks
JDK-8261681 :  
Description
Mobile browsers such as Safari on iPhone or Chrome on Android phones use very small fonts for some parts of javadoc generated API docs, while other parts are displayed in larger/normal font size. Affected parts include the navigation bar, certain type links, summary tables and parameter and exception clauses in member signatures (see attached pictures).

This is caused by browsers on devices with smaller screens use a viewport to scale web pages that are not optimized for mobile use. The solution is probably to use the viewport meta tag [1] in combination with CSS media queries [2] to make javadoc generated pages display well on devices with smaller screens.

[1] https://developer.mozilla.org/de/docs/Mozilla/Mobile/Viewport_meta_tag
[2] https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries
Comments
Changeset: 644271e7 Author: Hannes Walln��fer <hannesw@openjdk.org> Date: 2020-11-27 15:31:56 +0000 URL: https://git.openjdk.java.net/jdk/commit/644271e7
27-11-2020