jsUI-Toolbar var mytoolbar = new Object(); mytoolbar = toolbarNew("mytoolbar", "default", document.getElementById("toolbarCell"), null); mytoolbar.itemClick = doClick; mytoolbar.createButton("button1", "First Button", "../images/icon.jpg"); The toolbar is a navigation control, based on those frequently found in Windows or the MacOS. It is compatible with Internet Explorer 5.0 and FireFox 1.0 or better. jsUI-Global/common.js jsUI-Global/uiCommon.js jsUI-Toolbar/component.js index.htm

The DOM object to which the toolbar is attached. Frequently a DIV or TD.

alert (mytoolbar.toolbarParent.id); DOM Object. This property is assigned on instantiation and is read only.

Gets or sets the string value representing the path to the root of the jsObjects directory. Used for calculating style and graphics file paths. Initially set during instantiation.

mytoolbar.rootDir = "http://localhost/libraries/jsobjects"; http://<server>/jsObjects String. This value only needs to be set if jsObjects is installed in a custom location.

Instantiates the toolbar through assignment into a Javascript object.

The name for the new toolbar. Must match the name of an empty Javascript object to contain the toolbar. The name of the CSS (excluding the extension and path) file to use for the toolbar. If left blank, "default" will be used. The DOM object that the toolbar is to be attached to. If no value is passed, the toolbar will be appended to document.body The path to the root of the jsObjects directory. If left blank, the default path will be used. var mytoolbar = new Object(); mytoolbar = toolbarNew("mytoolbar", "default", document.getElementById("toolbarDiv"), "../jsobjects"); The toolbar object. This is the only method that does not appear to be a member of the object -- because the object can't have members until it's instantiated. A blank object is created and will be filled with the jsUI-Toolbar members.

Creats a button on the toolbar.

Required. A unique string to be used as the DOM ID for the new button. Required. The ALT text (or tooltip) to show for the button when the mouse pointer hovers over it. Required. The path to the image file to use as an icon for the button. Images should be 16x16 pixels. GIF files with transparency usually look best. Nothing

Creates a seperator on the toolbar to be used for grouping buttons.

Nothing

Creates a list item that can be added to a list box on the toolbar using the createList function.

Required. A unique string to be used as the DOM ID for the new list item. Required. The text that the users sees in the list. Required. The value of the list item. var listArray = new Array(); listArray[0] = mytoolbar.createListItem("List1Item1", "First Item in List", "Item1Value"); An list item object that can be added to a toolbar list.

Creates a list box in the specified folder in the toolbar.

Required. A unique string to be used as the DOM ID for the new list. Required. The text that shows in the list box when there are no items selected. Pass an empty string ("") to leave empty. Required. An array of objects created by the createListItem method. Optional. The width, in pixels, for the new list box on the toolbar. Nothing

Fires whenever a button is clicked, passing the ID of target object, so that external code can respond.

mytoolbar.itemClick = handler; The handler should accept one string parameter which will contain the ID of the button clicked.