jsLib uses two kinds of files:

• JavaScript files - layout the display, set up the menus, and manage the content.
• Cascading Style Sheet (CSS) files - control style aspects of the display.

The list below shows the JavaScript files that make up jsLib. Their classes and objects appear in parentheses.

• log.js (Log)
• utility.js (Loader, Log, DOM, Behavior)
• layout.js (Visual, Pane, Frame)
• url.js (URL)
• importer.js (Importer)
• page.js (Page, Repository)
• section.js (Section)
• menu.js (MenuItem, Menu)
• start.js (Start)

View log.js

• Log singleton - logs debugging messages.

  Messages can be added to the Log and later displayed as alerts.

View utility.js

• Loader singleton - handles asynchronous loads of content from other web pages.

  The Loader is used by pages to retrieve their HTML or XHTML content.

• DOM singleton - provides a variety of services for manipulating DOM elements.

  Services that add, remove or replace children support logging.

• Education singleton - provides methods for identifying "student" objects and logging their education.

  This adds some methodology for dynamically adding methods to objects.

View layout.js

• VisualU educator singleton - educates DOM elements to be visual objects:

  A visual is an object that sizes itself to fit into a pane.

• PaneU educator singleton - educates DOM elements to be pane objects.

  A pane is an object that represents a portion of the browser display area.

• Layout singleton - manages layout of panes and their visuals.

  Most presentations lay out at least two panes:

  • a navigation pane that displays a cascaded menu, and
  • a content pane that displays the section selected in the navigation pane

View url.js

• URL class - the constructor for url objects.

  A url object represents an absolute url. It can be used to resolve relative urls.

View importer.js

• Importer singleton - imports DOM elements loaded from external pages.

  Elements from external pages must be imported to work correctly in a presentation. The Importer ensures that their relative urls are resolved correctly.

View page.js

• Page class - the constructor for page objects.

  A page represents an HTML or XHTML document and provides access to its elements. Pages are only accessed indrectly through the Repository singleton.

• LoadErrorPageU educator singleton - teaches pages to be load error indicator pages.

  A load error indicator page represents a failure to load a page, possibly due to a url error on the part of the presentation author. It contains a single element that describes a page load error.

• Repository singleton - provides access to all elements in a complex document.

  The Repository retains all pages from which elements have been loaded. Later element accesses from a loaded page will be made without using the network.

View section.js

• SectionU educator singleton - educates an element to be a section.

  A section contains content to be displayed in a pane. It may contain a menu that is added to the menu cascade when the section or its descendents are displayed.

View menu.js

• MenuItemU educator singleton - educates a <li> with class "link" to be a menu item.

  A menu item appears in a menu. MenuItemU directs further education of a menu item ensuring that it eventually gets a section attached to it. When the user clicks on the menu item its section is displayed in a content pane.

• ErrorMenuItemU educator singleton - educates a menu item to be an error menu item.

  An error menu item indicates an error by the web page author. This happens, for example, if the <li> tag does not contain a <a> tag.

• DeferredMenuItemU educator singleton - educates a menu item to be a deferred menu item.

  A deferred menu item is a menu item that does not yet have a section attached to it. All menu items except default menu items and error menu items are initially deferred menu items. A deferred menu item gets a section attached to it after the user clicks on it. Then it will be educated to be either a leaf menu item or a nonleaf menu item, depending on whether or not the attached section contains a menu.

• LeafMenuItemU educator singleton - educates a menu item to be a leaf menu item.

  The section attached to a leaf menu item has no menu.

• DefaultMenuItemU educator singleton - educates a menu item to be a default menu item.

  The section attached to a default menu item is the section that contains the menu that contains the menu item. Every section has a default menu item.

• NonleafMenuItemU educator singleton - educates a menu item to be a nonleaf menu item.

  The section attached to a nonleaf menu item has a menu.

• MenuU educator singleton - educates a <div> with class "menu" to be a menu.

  A menu contains menu items. It may be one of several menus that appear as a menu cascade in a navigation pane.

View start.js

• Start singleton - provides a start() method for easy setup of web pages that use jsLib.

  The start() method is assigned to window.onload. More methods may be added later to allow different configurations of a presentation.

The list below shows the Cascading Style Sheet files used in jsLib.

• library.css - sets the non-color aspects of style.
• blue.css - sets the color aspects of style for a blue theme.
• green.css - sets the color aspects of style for a green theme.
• yellow.css - sets the color aspects of style for a yellow theme.
• tan.css - sets the color aspects of style for a tan theme.