dijit.hccss

since:v1.7

Introduction

By doing a require() of “dijit/hccss”, the “dijit_a11y” CSS class will be added to your document’s <body> tag if the machine is in high contrast mode, and thus the browser doesn’t display background images. This is useful for Internet Explorer and Firefox running on Windows. It doesn’t apply to Chrome or Safari (on mobile, mac, or desktop), which always display background images.

Usage

Simply require the module:

require(["dijit/hccss"]);

And then reference the class name from CSS rules, etc.:

.myTitlePane .label {
     /* normally hide the label in preference to the icon */
     display: none;
}
.dijit_a11y .myTitlePane .label {
     /* but display the label in high contrast mode, since the icon won't appear */
     display: block;
 }

Execution Time

Note that the dojo/domReady! dependency (if present) will resolve before the CSS class is added. Thus if your widget has javascript sizing code, it’s not sufficient to wait for dojo/domReady!. Rather, the widget should be instantiated inside of a ready() call:

require(["dojo/ready", "dijit/hccss"], function(ready){
     ready(function(){      // wait for DOMReady and for hccss code to execute
        new MyTitlePane(...);
     });
});
Error in the documentation? Can’t find what you are looking for? Let us know!