Conditional Compilation of JScript/ JavaScript in IE
In IE, there is a little known feature called conditional compilation.
Supported since IE4, this feature starting getting some attention when it
began showing up in some Ajax related JavaScripts. An absolute form of object
detection, conditional compilation lets you dictate to IE whether to compile
certain parts of your JScript or JavaScript code depending on predefined and user defined conditions. Think of it as
conditional comments
for your script that can also be molded to work gracefully with non IE
browsers as well.
Syntax Overview
Conditional compilation is activated by using the @cc_on statement
inside your script, or by directly using an @if or @set statement
that are part of the logic of CC. Here's an illustrative example:
<script type="text/javascript">
/*@cc_on
document.write("JScript version: " + @_jscript_version + ".<br>");
/*@if (@_jscript_version >= 5)
document.write("JScript Version 5.0 or better.<br \/>");
document.write("This text is only seen by browsers that support JScript 5+<br>");
@else @*/
document.write("This text is seen by all other browsers (ie: Firefox, IE 4.x etc)<br>");
/*@end
@*/
</script>
Example:
If you're using IE (of any version), you should see the first
document.write() rendered, and for IE5+, the following two document.write() as
well (since JScript 5 is supported by IE5+). The last document.write() method is
served only to non IE5+ browsers, whether it's Firefox, Opera, IE4, you name it.
Conditional compilation relies on tag teaming with the comment tag, similar to
in Conditional Comments, to ensure it works harmoniously in all browsers.
When working with Conditional Compilation, it's best to first activate it via
the @cc_on statement, as only then can you also
include comment tags in your script in a way that ensures browser compatibility,
as shown in the example above.
@if, @elif, @else, and @end statements
So with the formalities out of the way, here are the conditional statements
at your disposal for conditional compilation:
Lets see some "eccentric" examples now.
if else logic (IE exclusive)
/*@cc_on
@if (@_win32)
document.write("OS is 32-bit. Browser is IE.");
@else
document.write("OS is NOT 32-bit. Browser is IE.");
@end
@*/
Here the entire script is only rendered by IE browsers and ignored by all
else, and depending on the bit of your OS, a different message is shown.
Contrast that with the next example...
if else logic II (other browsers inclusive)
/*@cc_on
/*@if (@_win32)
document.write("OS is 32-bit, browser is IE.");
@else @*/
document.write("Browser is not IE (ie: is Firefox) or Browser is not 32 bit IE.");
/*@end
@*/
By manipulating the comment tag, the "else" part in this example will
get picked up by all non IE browsers such as Firefox, plus non 32 bit IE as
well. Study the comments until your head spins, and you'll see the logic. :)
if, elseif, else logic (IE exclusive)
Moving on, time for the full Monty:
/*@cc_on
@if (@_jscript_version >= 5)
document.write("IE Browser that supports JScript 5+");
@elif (@_jscript_version >= 4)
document.write("IE Browser that supports JScript 4+");
@else
document.write("Very old IE Browser");
@end
@*/
if, elseif, else logic II (other browsers inclusive)
/*@cc_on
/*@if (@_jscript_version >= 5)
document.write("IE Browser that supports JScript 5+");
@elif (@_jscript_version >= 4)
document.write("IE Browser that supports JScript 4+");
@else @*/
document.write("Non IE Browser (one that doesn't support JScript)");
/*@end
@*/
Sane deal here. In this 2nd example of the 2nd set, the final "else"
statement gets picked up by non IE browsers.
|