rspec/rules/S1090/html/rule.adoc

30 lines
1.0 KiB
Plaintext
Raw Normal View History

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.
2021-04-28 16:49:39 +02:00
== Noncompliant Code Example
----
<frame src="index.php?p=menu"> <-- Non-Compliant -->
<frame src="index.php?p=home" name="contents"> <-- Non-Compliant -->
----
2021-04-28 16:49:39 +02:00
== Compliant Solution
----
<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[]
'''
== Comments And Links
(visible only on this page)
include::comments-and-links.adoc[]
endif::env-github,rspecator-view[]