Replacing <noscript>

Let's Go!

Navigating the tutorial

Please use the navigation section on the left side of each web document to view the tutorial topics, and the TOP button at the end of each page section to return to the top of the page.

This Fast Track tutorial demonstrates how to replace the <noscript> markup element with an unobtrusive DOM/JavaScript function named noscript.js.

Peter-Paul Koch in his book "ppk on JavaScript", points out that the <noscript></noscript> element has a limitation. Modern user agents with JavaScript enabled will hide content contained within <noscript></noscript>, and reveal it when JavaScript is disabled. User agents that do not support JavaScript will display the content within it. User agents with partial/antiquated JavaScript capabilities however interpret the element correctly and do not show the content, but when JavaScript is disabled also do not show the content - it never gets seen. This has an impact on the accessibility of the content.

If your writing is targeted at modern, standards-based, compliant, and fully capable JavaScript user agents, employing the <noscript> element is no problem. If the user agents among your audience are unpredictable, however, replacing the <noscript> element with another mechanism becomes significant. This article looks at one such solution.

The solution

So, how can the behavior intended by the <noscript> markup element be enabled in these antiquated/partially-capable JavaScript user agents?

The workflow for my solution is as follows:

  1. Insert an unobtrusive JavaScript "hook" via an id attribute value in the parent container's opening tag.
  2. Associate the "hook" with an external JavaScript function, which sets up a parent-to-child relationship between the container and its content.
    1. When Javascript is enabled, the external function keeps the alternative content hidden.
    2. If the user agent cannot interpret the JavaScript expressions, the alternative content in the markup is revealed.
    3. When Javascript is disabled the function no longer works, and the alternative content in the markup is revealed.
      1. This ensures graceful degradation of the script, and access to the alternative, hidden content.

Building the Markup

In this section you'll build the markup portion of the example.

  1. In the <head></head> element of the web page, insert a <script></script> element containing the path to the external noscript.js JavaScript file:
  2. Create a <div></div> within the <body></body> element to contain the hidden content.
  3. Give the opening tag of the <div> an id attribute with a value of "noscript", that is, <div id="noscript">
    1. This sets the unobtrusive hook to the external JavaScript function noscript().
  4. Place all elements and content to be hidden while JavaScript is enabled within the <div id="noscript"></div> container.

The following web page markup sample illustrates this:

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  2. "http://www.w3.org/TR/html4/strict.dtd">
  3. <html lang="en">
  4. <head>
  5.   <title>noscript_example</title>
  6.   <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
  7.   <script src="scripts/noscript.js" type="text/javascript"></script>
  8. </head>
  9. <body>
  10.   <div id="noscript">
  11.     <p>
  12.       Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
  13.     </p>
  14.     <ul>
  15.       <li><a href="#">Hyperlink A</a></li>
  16.       <li><a href="#">Hyperlink B</a></li>
  17.     </ul>
  18.   </div>
  19. </body>
  20. </html>

top

Building the unobtrusive DOM/JavaScript

In this section I'll take you through building up the two main sections of the JavaScript.

Writing the if() portion of the function

  1. Between the if parentheses, place the document.removeChild expression - this tests to see if it is supported by the user agent.
    1. If it is supported the function will continue, and the div content will remain hidden.
    2. If it is not supported the function progresses to the else if() statement and tests it.
  2. Declare the container div element and identify its id value as the external, unobtrusive "hook" to the markup.
  3. Instruct the parent div to remove all child content within it.

Writing the else if() portion of the function

  1. Between the else if parentheses, place the document.getElementById expression to test if it is supported by the user agent.
    1. If it is supported the function will continue, and the div content will remain hidden.
    2. If it is not supported the function will end, and the div content will be revealed, establishing graceful degradation of the script.
  2. Return the element id where the style will be applied.
  3. Set its style.display to "none" to control the presentation aspect of the child content.

The following JavaScript functions are contained in the noscript.js file, which is kept external to the web page in the scripts folder, and linked to the web page as described in the "Building the Markup" section.

  1. /* noscript.js */
  2. function addLoadEvent(func) {
  3.   var oldonload = window.onload;
  4.   if (typeof window.onload !== "function") {
  5.     window.onload = func;
  6.   } else {
  7.       window.onload = function () {
  8.   if (oldonload) {
  9.       oldonload();
  10.       }
  11.   func();
  12.       };
  13.     }
  14.   }
  15.   var noscript = addLoadEvent(noscript);
  16.   addLoadEvent(function () {
  17.   /* more code to run on page load */
  18.   });
  19.  
  20. function noscript() {
  21.   if (document.removeChild)
  22.     {
  23.       var div = document.getElementById("noscript");
  24.       div.parentNode.removeChild(div);
  25.     }
  26.   else if (document.getElementById)
  27.     {
  28.     document.getElementById("noscript").style.display = "none";
  29.     }
  30.   }

Summary

This article demonstrates a solution that replaces the <noscript></noscript> markup element with an external, unobtrusive JavaScript function. The noscript() function solves the problem that partially-capable/antiquated JavaScript user agents have with not revealing alternative content if JavaScript is disabled. Employing this function, they will reveal the content as intended. This ensures graceful degradation of the script, and full accessibility to the alternative content.

top