Using in an Application

In your application, first include all required JavaScript files. First, you need the browser sniffer, browserSniffer.js. Then, you need the class that creates the browser-dependent class, createTheProperSubClass.js. Notice again the sophistication here: we have a class generating another class on the fly. The third file you need to include is the superclass of DOCJSLIB 1.2, docjslibSuperClass.js. It defines the browser-independent method and properties that we can later add to and override in our browser-dependent subclasses. Finally, you need to include all our subclasses. In our case, we have four: docjslibIE4SubClass.js, docjslibIE5SubClass.js, docjslibNS4SubClass.js, and docjslibNS6SubClass.js. Here is again the beginning of our application:

<SCRIPT LANGUAGE="JavaScript" SRC="browserSniffer.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="createTheProperSubClass.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="docjslibSuperClass.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="docjslibIE4SubClass.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="docjslibIE5SubClass.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="docjslibNS4SubClass.js"></SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="docjslibNS6SubClass.js"></SCRIPT>

You need to copy and paste the above lines in the beginning of any application that uses DOCJSLIB. Inside your application, you need to create two object. The first one, called here classSelectionObj, creates the browser detection and generation object:

var classSelectionObj = new createTheProperSubClass();

Notice that we haven't created yet the browser-dependent object. We just created an object of the class createTheProperSubClass() which, as you recall, detects the browser and defines (but does not call) the method getTheProperSubClass(). Now that we created the object classSelectionObj, we can call its method to generate the browser-dependent API object:

var myBrowserAPIObj = classSelectionObj.getTheProperSubClass();

Now we have an object, myBrowserAPIObj, that includes all methods of the browser-dependent version of DOCJSLIB 1.2. Every call to one of DOCJSLIB's methods should be preceded with the object name. For example:

  myBrowserAPIObj.setSrc(id, "xbutton.gif");

Next: Tic-Tac-Toe board game