rspec/rules/S1092/html/rule.adoc

43 lines
999 B
Plaintext
Raw Normal View History

2021-04-28 16:49:39 +02:00
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.
2021-04-28 16:49:39 +02:00
== Noncompliant Code Example
2022-02-04 17:28:24 +01:00
[source,html]
2021-04-28 16:49:39 +02:00
----
<a href="image.png">...</a> <!-- Non-Compliant -->
----
2021-04-28 16:49:39 +02:00
== Compliant Solution
2022-02-04 17:28:24 +01:00
[source,html]
2021-04-28 16:49:39 +02:00
----
<a href="page.html">...</a> <!-- Compliant -->
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
include::message.adoc[]
'''
== Comments And Links
(visible only on this page)
include::comments-and-links.adoc[]
endif::env-github,rspecator-view[]