dojo.provide("dijit._base.wai"); dijit.wai = { onload: function(){ // summary: // Detects if we are in high-contrast mode or not // This must be a named function and not an anonymous // function, so that the widget parsing code can make sure it // registers its onload function after this function. // DO NOT USE "this" within this function. // create div for testing if high contrast mode is on or images are turned off var div = dojo.create("div",{ id: "a11yTestNode", style:{ cssText:'border: 1px solid;' + 'border-color:red green;' + 'position: absolute;' + 'height: 5px;' + 'top: -999px;' + 'background-image: url("' + (dojo.config.blankGif || dojo.moduleUrl("dojo", "resources/blank.gif")) + '");' } }, dojo.body()); // test it var cs = dojo.getComputedStyle(div); if(cs){ var bkImg = cs.backgroundImage; var needsA11y = (cs.borderTopColor==cs.borderRightColor) || (bkImg != null && (bkImg == "none" || bkImg == "url(invalid-url:)" )); dojo[needsA11y ? "addClass" : "removeClass"](dojo.body(), "dijit_a11y"); if(dojo.isIE){ div.outerHTML = ""; // prevent mixed-content warning, see http://support.microsoft.com/kb/925014 }else{ dojo.body().removeChild(div); } } } }; // Test if computer is in high contrast mode. // Make sure the a11y test runs first, before widgets are instantiated. if(dojo.isIE || dojo.isMoz){ // NOTE: checking in Safari messes things up dojo._loaders.unshift(dijit.wai.onload); } dojo.mixin(dijit, { _XhtmlRoles: /banner|contentinfo|definition|main|navigation|search|note|secondary|seealso/, hasWaiRole: function(/*Element*/ elem, /*String*/ role){ // summary: // Determines if an element has a particular non-XHTML role. // returns: // True if elem has the specific non-XHTML role attribute and false if not. // For backwards compatibility if role parameter not provided, // returns true if has non XHTML role var waiRole = this.getWaiRole(elem); return role ? (waiRole.indexOf(role) > -1) : (waiRole.length > 0); }, getWaiRole: function(/*Element*/ elem){ // summary: // Gets the non-XHTML role for an element (which should be a wai role). // returns: // The non-XHTML role of elem or an empty string if elem // does not have a role. return dojo.trim((dojo.attr(elem, "role") || "").replace(this._XhtmlRoles,"").replace("wairole:","")); }, setWaiRole: function(/*Element*/ elem, /*String*/ role){ // summary: // Sets the role on an element. // description: // In other than FF2 replace existing role attribute with new role. // FF3 supports XHTML and ARIA roles so // if elem already has an XHTML role, append this role to XHTML role // and remove other ARIA roles. // On Firefox 2 and below, "wairole:" is // prepended to the provided role value. var curRole = dojo.attr(elem, "role") || ""; if(dojo.isFF < 3 || !this._XhtmlRoles.test(curRole)){ dojo.attr(elem, "role", dojo.isFF < 3 ? "wairole:" + role : role); }else{ if((" "+ curRole +" ").indexOf(" " + role + " ") < 0){ var clearXhtml = dojo.trim(curRole.replace(this._XhtmlRoles, "")); var cleanRole = dojo.trim(curRole.replace(clearXhtml, "")); dojo.attr(elem, "role", cleanRole + (cleanRole ? ' ' : '') + role); } } }, removeWaiRole: function(/*Element*/ elem, /*String*/ role){ // summary: // Removes the specified non-XHTML role from an element. // Removes role attribute if no specific role provided (for backwards compat.) var roleValue = dojo.attr(elem, "role"); if(!roleValue){ return; } if(role){ var searchRole = dojo.isFF < 3 ? "wairole:" + role : role; var t = dojo.trim((" " + roleValue + " ").replace(" " + searchRole + " ", " ")); dojo.attr(elem, "role", t); }else{ elem.removeAttribute("role"); } }, hasWaiState: function(/*Element*/ elem, /*String*/ state){ // summary: // Determines if an element has a given state. // description: // On Firefox 2 and below, we check for an attribute in namespace // "http://www.w3.org/2005/07/aaa" with a name of the given state. // On all other browsers, we check for an attribute // called "aria-"+state. // returns: // true if elem has a value for the given state and // false if it does not. if(dojo.isFF < 3){ return elem.hasAttributeNS("http://www.w3.org/2005/07/aaa", state); } return elem.hasAttribute ? elem.hasAttribute("aria-"+state) : !!elem.getAttribute("aria-"+state); }, getWaiState: function(/*Element*/ elem, /*String*/ state){ // summary: // Gets the value of a state on an element. // description: // On Firefox 2 and below, we check for an attribute in namespace // "http://www.w3.org/2005/07/aaa" with a name of the given state. // On all other browsers, we check for an attribute called // "aria-"+state. // returns: // The value of the requested state on elem // or an empty string if elem has no value for state. if(dojo.isFF < 3){ return elem.getAttributeNS("http://www.w3.org/2005/07/aaa", state); } return elem.getAttribute("aria-"+state) || ""; }, setWaiState: function(/*Element*/ elem, /*String*/ state, /*String*/ value){ // summary: // Sets a state on an element. // description: // On Firefox 2 and below, we set an attribute in namespace // "http://www.w3.org/2005/07/aaa" with a name of the given state. // On all other browsers, we set an attribute called // "aria-"+state. if(dojo.isFF < 3){ elem.setAttributeNS("http://www.w3.org/2005/07/aaa", "aaa:"+state, value); }else{ elem.setAttribute("aria-"+state, value); } }, removeWaiState: function(/*Element*/ elem, /*String*/ state){ // summary: // Removes a state from an element. // description: // On Firefox 2 and below, we remove the attribute in namespace // "http://www.w3.org/2005/07/aaa" with a name of the given state. // On all other browsers, we remove the attribute called // "aria-"+state. if(dojo.isFF < 3){ elem.removeAttributeNS("http://www.w3.org/2005/07/aaa", state); }else{ elem.removeAttribute("aria-"+state); } } });