What is `legendLinks`?

[zcorpan]

    readonly attribute LegendLink[] legendLinks;

What is this?

[prushforth]

It is used to make available the set of <link rel="legend" href="..."> links that are included in the layer's document, and the first such link is rendered as a <a href="...">layer-name</a> in the layer control entry for the layer:

[ahmadayubi]

It might be worthwhile thinking about having legends rendered on top of the map in one of the corners. As most modern web maps containing legends have them visually represented on the map itself as an image (i.e. Google Map JavaScript API ).

[prushforth]

I'm more on the side of leaving this in the domain of custom controls as of now, but they are definitely needed for many maps.

That said, legendLinks[] might not be the right API to support, TBD.

[Malvoz]

I think the concept of "legend links" is problematic because:

1. It isn't apparent that the link is a destination for legend information (link name derived from the layer name, in the layer control).
2. It requires the user to navigate away from the current document to recieve the information (which in the example in What is legendLinks? #80 (comment) is an image with the accessible name of "toporama_en (219×551)", which isn't very useful).
3. Hard/impossible(?) to define a relationship between an object on a map and its corresponding description (if the object and the description lived in the same document you could perhaps define the relationship using aria-details for example, at least in a polyfill/JS library).

Do we have a UCR issue for this use case and/or capability?

[prushforth]

Do we have a UCR issue for this use case and/or capability?

If we don't, we should do. It was added to support WMS and WMTS legend links capabilities, because originally I held that support for WMS and WMTS were baseline requirements, so I did my best to accommodate their facilities.

That said, maybe the facility could be reimagined with a better and more accessible UI, and possibly a better API even. Often times a legend is a vital bit of meta-information about the map, and could be super useful for low-vision users etc.

[Malvoz]

legendLinks removed in #213.