From 9c27c7e281a54e8819d256b7ac054f77cf957631 Mon Sep 17 00:00:00 2001
From: Trevor Elliott <trevor@galois.com>
Date: Wed, 26 Jun 2013 10:50:51 -0700
Subject: Rename the accessibility directory

 * Accessibility was too general, these were only WCAG-1.0
---
 guidelines/WCAG-1.0/guideline-1.js | 95 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 guidelines/WCAG-1.0/guideline-1.js

(limited to 'guidelines/WCAG-1.0/guideline-1.js')

diff --git a/guidelines/WCAG-1.0/guideline-1.js b/guidelines/WCAG-1.0/guideline-1.js
new file mode 100644
index 0000000..61e1384
--- /dev/null
+++ b/guidelines/WCAG-1.0/guideline-1.js
@@ -0,0 +1,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);
+    }
+  });
+
+};
-- 
cgit v1.2.3