Guide to Sample Pages

Listed below are the 4 main example pages generated by SiteSurfer Builder. Each uses HTML frames to control the layout of pages, so that the applet runs in one frame, and documents are displayed in another. Alternatively you may choose to forgo frames and instead embed the applet in a top-level browser window. If you choose this second option, be careful how you configure the HELPURL and DOCUMENTFRAME applet parameters, so they do not specify the same frame or browser window as the applet. If the browser loads another document over an applet, the applet will stop running, and will need to be reloaded the next time you visit the applet page.

• Column Frame Example (colframe.htm). This example puts SiteSurfer in a frame at the left and the document area in a frame on the right. Clicking on an item in SiteSurfer will load that page in the document frame.

• Row Frame Example (rowframe.htm). This example is different from the Column Frame example in 2 ways. First, SiteSurfer is in a frame at the top and the document area in a frame at the bottom. Second, SiteSurfer is configured with the RESULTSTYPE parameter to display the search results list in a new window, rather than embedded within the applet.

• Button Frame Example (butframe.htm). This example illustrates a totally different way of launching SiteSurfer. Here, the DISPLAYTYPE parameter tells the program to load only a button. Clicking on the button loads a window containing the main SiteSurfer interface. It is still important that the frame showing the button does not get overwritten or closed, because that will close SiteSurfer.

• JavaScript Frame Example (scrframe.htm). This example illustrates one way of using JavaScript in HTML to launch an applet. Clicking on the Powered By SiteSurfer image, which is actually an HTML link, executes a JavaScript script that first checks if the browser version supports Java 1.1, and then opens a new browser window. Finally, the script writes HTML tags into the new window which tell it to load SiteSurfer. If JavaScript or Java are disabled or unsupported, it should display an error message.

  When the JavaScript example executes SiteSurfer, it does so in a new, named window that is unlikely to be overwritten by opening a page anywhere else in the browser. Therefore, it is safe to close or replace the image link that launched the new window. Furthermore, SiteSurfer will continue running until you close its window. More information on this topic is available in Using JavaScript with Applets.