Techniques for WCAG 2.0

Skip to Content (Press Enter)

-

SVR2: Using .htaccess to ensure that the only way to access non-conforming content is from conforming content

Applicability

Content residing on a Web server that supports .htaccess (typically Apache) where a conforming version of content is provided as an alternative to a non-conforming version.

This technique relates to:

Description

The objective of this technique is to ensure that users can always access an accessible version of the content when non-conforming versions are also available. Whenever content is provided in a format that does not conform to WCAG, the site as a whole can still conform if alternate versions of the inaccessible content are provided. Conformance Criterion 4 requires that alternate versions can be derived from the nonconforming content or from its URI.

Since it is not always possible to provide an accessible link from within non-conforming content, this technique describes how authors can use Apache's Module "mod_access" to ensure that non-conforming content can only be accessed from URIs that serve as alternate versions to the non-conforming content or from pages that include links to both the non-conforming version and the alternative version.

Examples

Example 1

The following .htaccess file uses Apache's mod_redirect module to redirect requests for "inaccessible.html" to "accessible.html" unless the request comes from "accessible.html".


# If the request for inaccessible content comes from a file 

# called accessible.html, then set an environment variable that 

# allows the inaccessible version to be displayed.

SetEnvIf Referer .*(accessible.html)$ let_me_in

<FilesMatch ^(inaccessible.html)$>

    Order Deny,Allow

    Deny from all

    Allow from env=let_me_in

</FilesMatch>



# If the request comes from anyplace but accessible.html, then 

# redirect the error condition to a location where the accessible 

# version resides

ErrorDocument 403 /example_directory/accessible.html

Example 2

This example assumes a directory structure where documents are available in multiple formats. One of the formats does not meet WCAG at the level claimed and uses the file extension "jna" (Just Not Accessible). All of these files are stored in a folder called "jna" with an .htaccess file which ensures that any direct request for a file with the .jna extension from pages where inaccessible versions are not already available is redirected to an index page that lists all of the available formats.


# If the request for inaccessible content comes from a file at 

# http://example.com/documents/index.html, then set an environment 

# variable that allows the inaccessible version to be displayed.

SetEnvIf Referer ^http://example.com/documents/index.html$ let_me_in

<FilesMatch ^(.*\.jna)$>

    Order Deny,Allow

    Deny from all

    Allow from env=let_me_in

</FilesMatch>



# If the request comes from anyplace but http://example.com/documents/index.html, then 

# redirect the error condition to a location where a link the accessible 

# version resides

ErrorDocument 403 http://example.com/documents/index.html

Resources

Resources are for information purposes only, no endorsement implied.

Tests

Procedure

  1. Identify pages that do not conform to WCAG at the conformance Level claimed where accessible alternatives are served based on the use of .htaccess files.

  2. Visit the URI of the non-conforming content.

  3. Verify that the resulting page does one of the following:

    1. conforms at the level claimed

    2. includes a link to both the conforming and non-conforming content

Expected Results