Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8207931

Javadoc search result depends on where you click with your mouse

    Details

      Description

      ADDITIONAL SYSTEM INFORMATION :
      Reproduced with the Javadoc on https://download.java.net/java/early_access/jdk11/docs/api/ on 2018-07-19 (DRAFT 11-ea+22)

      Firefox 62.0b9 (64-bit) on Windows 10
      Chrome 67.0.3396.99 (Officiële build) (64-bits) on Windows 10

      A DESCRIPTION OF THE PROBLEM :
      When searching Javadoc for a class + method if you are already on javadoc page for that class, and then proceed to select a result entry by mouse click (instead of arrows + enter), the final page opened will either open at the top of the class or on the selected method. This is very confusing.

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      - Open Javadoc (eg https://download.java.net/java/early_access/jdk11/docs/api/)
      - In search enter String.getB
      => A dropdown with search results appears
      - Select String.getBytes() by mouse (click anywhere)
      => Javadoc opens on entry for getBytes() (eg https://download.java.net/java/early_access/jdk11/docs/api/java.base/java/lang/String.html#getBytes() )
      - In search, enter String.getB again
      => A dropdown with search results appears
      - Select by mouse (but don't click yet): String.getBytes(Charset)

      The result now depends on where you click (and this behaviour is not 100% consistent):
      1.
      - Click on the package, class, method name or parameter list of the selected entry
      => goes to the top of the String class javadoc
      - Click on back button on browser
      => goes to the documentation of the method we just selected (that is: String.getBytes(Charset))

      In other words: it first went to the right entry, and then went on to the top of the javadoc page.

      2.
      - Click **after** the closing ) of the parameter list in the selectedentry
      => goes to the entry of String.getBytes(Charset) (eg https://download.java.net/java/early_access/jdk11/docs/api/java.base/java/lang/String.html#getBytes(java.nio.charset.Charset))

      I have observed some inconsistencies while reproducing: sometimes it does work when clicking on the method and beyond, sometimes it works when clicking near the top of the selection box (horizontal position then doesn't seem to matter).

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      The javadoc should always open on the selected method, no matter where was clicked in the entry in the search result list
      ACTUAL -
      The javadoc first opens the selected method and then immediately scrolls to the top of the class entry.

      CUSTOMER SUBMITTED WORKAROUND :
      Use arrow + enter for selection or click after the method in the search result (harder to do for longer methods)

      FREQUENCY : always


        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                hannesw Hannes Wallnoefer
                Reporter:
                webbuggrp Webbug Group
              • Votes:
                0 Vote for this issue
                Watchers:
                4 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: