RFR: JDK-8277420: Provide a way to copy the hyperlink to a doc element to the clipboard

[Jorn Vernee]

On Fri, 20 May 2022 17:20:19 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> This is a CSS/JavaScript only change to implement copy-to-clipboard functionality for all headers (`h1` - `h6`) that have an `id` attribute associated with them. The following element-attribute patterns are supported (using `<h2>` as an example):
> 
>  - `<section id="..."><h2>` (generated by javadoc)
>  - `<h2 id="...">` (commonly used)
>  - `<h2><a id="...">` (legacy)
> 
> The change includes a consolidation of the CSS styles used to render copy-to-clipboard buttons, of which we have now three kinds: for snippets, for the link on the search page, and for headers. There is now a base CSS class called "copy" that defines the styles shared by all copy-to-clipboard buttons, and additional CSS properties for the concrete "subclasses". 
> 
> API docs generated with this change can be viewed here (top level files and java.base module):
> http://cr.openjdk.java.net/~hannesw/8277420/api.02/

Very nice!

I'm trying this out by getting a link to the "Signature Polymorphism" section in the class javadoc here: http://cr.openjdk.java.net/~hannesw/8277420/api.02/java.base/java/lang/invoke/MethodHandle.html

The source for that is `<h2><a id="sigpoly"></a>Signature polymorphism</h2>` but no link/copy button seems to be generated. Shouldn't this also have a button? (seems to fall in the legacy category)

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

PR: https://git.openjdk.java.net/jdk/pull/8817