On Wed, 6 May 2026 08:44:37 GMT, Hannes Wallnöfer <[email protected]> wrote:

> Please review a change to improve the target highlight for javadoc member 
> details sections.
> 
> Instead of highlighting the member header by changing its background color, 
> we now add a subtle accent bar to the left side of the header. The bar is 
> implemented as `box-shadow`, is just outside the header element and does not 
> cause a layout shift. It uses the theme's link color with an alpha of 70%, 
> which seems to work well in both themes. 
> 
> The accent bar is wide enough to be noticeable, but nowhere near as 
> distractive as the old highlight, and brings our documentation more in line 
> with modern documentation/UI patterns.
> 
> I also slightly increased the `scroll-margin-top` property of elements to 
> position them a bit further from the navigation bar when targeted by id.
> 
> Sample docs for the `java.lang` package are [available 
> here](https://cr.openjdk.org/~hannesw/8383906/api.00/java.base/java/lang/Object.html#hashCode()).
> 
> ---------
> - [x] I confirm that I make this contribution in accordance with the [OpenJDK 
> Interim AI Policy](https://openjdk.org/legal/ai).

This pull request has now been integrated.

Changeset: ef3c786d
Author:    Hannes Wallnöfer <[email protected]>
URL:       
https://git.openjdk.org/jdk/commit/ef3c786d362be9dd4228b923dcab847c97b7bf84
Stats:     10 lines in 1 file changed: 3 ins; 5 del; 2 mod

8383906: Target highlight in member details is too aggressive

Reviewed-by: nbenalla

-------------

PR: https://git.openjdk.org/jdk/pull/31052

Reply via email to