blob: 61e1384407b874248fe9ee081e91be6644f0e4ea (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/**
* Provide equivalent alternatives to auditory and visual content
*/
exports.name = "Equivalent Alternatives";
exports.description = "";
exports.rule = function(report) {
/* Checkpoint 1.1 [Priority 1] **********************************************/
var hasAlt = function(ix) {
// TODO: strip space from the alt attribute to prevent ' ' from passing
// the test
if(_.isEmpty($(this).attr('alt')) && _.isEmpty($(this).attr('longdesc'))) {
report.error('No alt/longdesc specified', this);
}
};
var hasText = function(ix) {
// TODO: strip space from the text to prevent ' ' from passing the test
if(_.isEmpty($(this).text())) {
report.error('No text node', this);
}
};
// images with semantic meaning should have an alt attribute.
$5('a').find('img')
.add($5('dl').find('img'))
.add($5('dd').find('img'))
.each(hasAlt);
// All `input` tags must have an alt attribute.
$5('input').each(hasAlt);
// All `applet` tags must have a text node
$5('applet').each(hasText);
// All `object` tags must have a text node
$5('object').each(hasText).each(hasAlt);
// TODO: what's the best way to classify content that's `complex`?
// All `area` elements of an image map should have alt attributes. It's also a
// bit overzealous, as it looks at all maps, not just maps that are referenced
// from images.
$5('map').find('area')
.add($5('map').find('a'))
.each(hasAlt);
// TODO: figure out a good way to handle frames.
// TODO: figure out a good way to handle scripts.
/* Checkpoint 1.2 [Priority 1] **********************************************/
// `ismap` is a boolean attribute. If it's present on an image, require that
// there's also a corresponding `usemap` attribute that can be used in lieu of
// having the server information present. This is a bit of an under
// approximation, as if you can provide a client-side map that doesn't cover
// everything that the server does. It's more of a sanity check, that this
// has been thought of.
$5('img').filter('[ismap]').each(function(ix) {
if(_.isEmpty($(this).attr('usemap'))) {
report.error('No usemap attribute to supplement a use of ismap', this);
}
});
/* Checkpoint 1.3 [Priority 1] **********************************************/
// TODO: Not really sure if this is something that we can check; the guideline
// seems to be more of a subjective check.
/* Checkpoint 1.4 [Priority 1] **********************************************/
// TODO: Again, not sure if this is something we can check here.
/* Checkpoint 1.5 [Priority 3] **********************************************/
// Make sure that every link in an image map has a corresponding text link
// somewhere else in the document.
var hrefs = $5('a').map(function() { return $(this).attr('href'); });
$5('map').find('area').each(function() {
var href = $(this).attr('href');
if(!_.contains(href, hrefs)) {
report.error('Image map contains a link not present in a text link',
this);
}
});
};
|