16f6c0aecf
Inline adoc files when they are included exactly once. Also fix language tags because this inlining gives us better information on what language the code is written in.
50 lines
1.1 KiB
Plaintext
50 lines
1.1 KiB
Plaintext
== Why is this an issue?
|
|
|
|
Whenever a user clicks on a link that targets an image, the website's navigation menu will be lost.
|
|
|
|
From a user point of view, it is as if she left the website.
|
|
|
|
The only way to return to it is using the browser's 'Back' button.
|
|
|
|
Instead, it is better to create a page which will display the image using the ``++<img>++`` tag and preserve the navigation menu.
|
|
|
|
|
|
Further, in terms of accessibility, when the image is embedded into a page, content providers are able to provide an alternate text equivalent through the ``++alt++`` attribute.
|
|
|
|
|
|
=== Noncompliant code example
|
|
|
|
[source,html]
|
|
----
|
|
<a href="image.png">...</a> <!-- Non-Compliant -->
|
|
----
|
|
|
|
|
|
=== Compliant solution
|
|
|
|
[source,html]
|
|
----
|
|
<a href="page.html">...</a> <!-- Compliant -->
|
|
----
|
|
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
Change this link to not directly target an image.
|
|
|
|
|
|
'''
|
|
== Comments And Links
|
|
(visible only on this page)
|
|
|
|
=== on 8 Jul 2013, 18:21:55 Freddy Mallet wrote:
|
|
Is implemented by \http://jira.codehaus.org/browse/SONARPLUGINS-2992
|
|
|
|
endif::env-github,rspecator-view[]
|