rspec/rules/S1090/html/rule.adoc

46 lines
1.3 KiB
Plaintext
Raw Permalink Normal View History

== Why is this an issue?
2021-04-28 16:49:39 +02:00
Frames allow different web pages to be put together on the same visual space. Users without disabilities can easily scan the contents of all frames at once. However, visually impaired users using screen readers hear the page content linearly.
The ``++title++`` attribute is used to list all the page's frames, enabling those users to easily navigate among them. Therefore, the ``++<frame>++`` and ``++<iframe>++`` tags should always have a ``++title++`` attribute.
=== Noncompliant code example
2021-04-28 16:49:39 +02:00
2022-02-04 17:28:24 +01:00
[source,html]
2021-04-28 16:49:39 +02:00
----
<frame src="index.php?p=menu"> <-- Non-Compliant -->
<frame src="index.php?p=home" name="contents"> <-- Non-Compliant -->
----
=== Compliant solution
2021-04-28 16:49:39 +02:00
2022-02-04 17:28:24 +01:00
[source,html]
2021-04-28 16:49:39 +02:00
----
<frame src="index.php?p=menu" title="Navigation menu"> <-- Compliant -->
<frame src="index.php?p=home" title="Main content" name="contents"> <-- Compliant -->
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Add a 'title' attribute to this {0} tag.
'''
== Comments And Links
(visible only on this page)
=== on 8 Jul 2013, 18:22:58 Freddy Mallet wrote:
Is implemented by \http://jira.codehaus.org/browse/SONARPLUGINS-2990
endif::env-github,rspecator-view[]