Command reference
By Erik Bosrup

1.
Introduction
This command reference lists the commands you can use to control overLIB. There are multiple ways to customize overLIB and using commands all the time is NOT the correct way of doing this. Read the documentation for more information about other ways to customize overLIB.

Remeber that commands are always in uppercase (case-sensitive) and can have none or many parameters.

2.
Behaviour, Positioning and Sizes

STICKY
Makes the popup stick around until closed.
Variable: ol_sticky.

WIDTH pixels
Sets the width of the box to some other size.
Variable: ol_width.

HEIGHT pixels
Sets the height of the box.
Variable: ol_height.

LEFT
Makes the popups go to the left of the mouse.
Variable: ol_hpos.

RIGHT
Makes the popups go to the right of the mouse.
Variable: ol_hpos.

CENTER
Makes the popups go to the center of the mouse.
Variable: ol_hpos.

ABOVE
Makes the popups go above the mouse. Note: Only possible when HEIGHT has been set.
Variable: ol_vpos.

BELOW
Makes the popups go below the mouse.
Variable: ol_vpos.

OFFSETX x
How far away from the pointer the popup will show up, horizontally.
Variable: ol_offsetx.

OFFSETY y
How far away from the pointer the popup will show up, vertically.
Variable: ol_offsety.

AUTOSTATUS
Sets the status bar's text to the popup's text. Overrides STATUS.
Variable: ol_autostatus.

AUTOSTATUSCAP
Sets the status bar's text to the popup's caption. Overrides AUTOSTATUS and STATUS.
Variable: ol_autostatus.

SNAPX grid
Snaps the popup to an even position in a horizontal grid.
Variable: ol_snapx.

SNAPY grid
Snaps the popup to an even position in a vertical grid.
Variable: ol_snapy.

FIXX position
Locks the popups horizontal position. Overrides all other horizontal placement.
Variable: ol_fixx.

FIXY position
Locks the popups vertical position. Overrides all other vertical placement.
Variable: ol_fixy.

FRAME frame
Controls popups in a different frame. Make sure you have the <DIV> tag in the target frame as well. The frame parameter passed to this command should not be a text string. This feature, although working well, is considered experimental. Example: overlib('Text', FRAME, parent.below), assuming you have a frame called below.
Variable: ol_frame.

TIMEOUT millisecs
Makes the popup go away after the requested delay.
Variable: ol_timeout.

DELAY millisecs
Makes that popup behave like a tooltip. It will popup only after a certain delay specified in millisecs.
Variable: ol_delay.

HAUTO
Automatically determine if the popup should be to the left or right of the mouse. This command toggles the feature on or off.
Variable: ol_hauto.

VAUTO
Automatically determine if the popup should be to the above or below of the mouse. This command toggles the feature on or off.
Variable: ol_vauto.

CLOSECLICK
Force users to click on "Close" to close sticky popups. This command toggles the feature on and off.
Variable: ol_closeclick.

3.
Colors, Fonts and Images

FGCOLOR color
Color of the inside of the popup box.
Variable: ol_fgcolor.

BGCOLOR color
Color of the border of the popup box.
Variable: ol_bgcolor.

TEXTCOLOR color
Sets the color of the text inside the box.
Variable: ol_textcolor.

CAPCOLOR color
Sets the color of the box's caption.
Variable: ol_capcolor.

CLOSECOLOR color
Sets the color of the close text.
Variable: ol_closecolor.

TEXTFONT font
Sets the font to be used by the main text.
Variable: ol_textfont.

CAPTIONFONT font
Sets the font of the caption.
Variable: ol_capfont.

CLOSEFONT font
Defines the font for the "Close" text.
Variable: ol_closefont.

TEXTSIZE size
Size of the main text's font.
Variable: ol_textsize.

CAPTIONSIZE size
Size of the caption's font.
Variable: ol_captionsize.

CLOSESIZE size
Size of the "Close" text's font.
Variable: ol_closesize.

FGBACKGROUND picture
Defines a picture to use instead of color for the inside of the popup. You will most likely want to set FGCOLOR to '' or the color will show as well.
Variable: ol_fgbackground.

BGBACKGROUND picture
Defines a picture to use instead of color for the border of the popup. You will most likely want to set BGCOLOR to '' or the color will show as well. When having a Close link, Netscape will re-render the table cells, making things look bad.
Variable: ol_bgbackground.

CAPICON url
Displays a small icon before the popup caption.
Variable: ol_capicon.

BORDER pixels
Makes the border of the popups thicker or thinner.
Variable: ol_border.

BACKGROUND picture
Instead of using the table box as background, your picture will be used.
Variable: ol_background.

PADX left right
Pads the background picture with horizontal whitespace for text placement. Note that this is a two parameter command.
Variable: ol_padxl and ol_padxr.

PADY top bottom
Pads the background picture with vertical whitespace for text placement. Note that this is a two parameter command.
Variable: ol_padyt and ol_padyb.

FULLHTML
Allows you to control the html over a BACKGROUND picture completely. The html code is expected in "text".
Variable: ol_fullhtml.

4.
Cascading Style Sheets

CSSOFF
Turns off CSS features and resorts to standard html tags.
Variable: ol_css.

CSSSTYLE
Turns on inline CSS style features.
Variable: ol_css.

CSSCLASS
Turns on CSS class features.
Variable: ol_css.

Class commands

FGCLASS class
Class for the inside table of the popup box. Requires CSSCLASS.
Variable: ol_fgclass.

BGCLASS class
Class for the outside table of the popup box. Requires CSSCLASS.
Variable: ol_bgclass.

TEXTFONTCLASS class
Class for the main text area. Requires CSSCLASS.
Variable: ol_textfontclass.

CAPTIONFONTCLASS class
Class for the caption text. Requires CSSCLASS.
Variable: ol_captionfontclass.

CLOSEFONTCLASS class
Class for the close tex. Requires CSSCLASS.
Variable: ol_closefontclass.

Style commands

PADUNIT unit
The unit to be used for table cell padding. Requires CSSSTYLE.
Variable: ol_padunit.

HEIGHTUNIT unit
The unit to be used for table heights. Requires CSSSTYLE.
Variable: ol_heighunit.

WIDTHUNIT unit
The unit to be used for table widths. Requires CSSSTYLE.
Variable: ol_widthunit.

TEXTSIZEUNIT unit
The unit to be used when specifying text sizes. Requires CSSSTYLE.
Variable: ol_textsizeunit.

TEXTDECORATION decoration
Decorates the text with underlines etc. Requires CSSSTYLE.
Variable: ol_textdecoration.

TEXTSTYLE style
Styles the text with italics etc. Requires CSSSTYLE.
Variable: ol_textstyle.

TEXTWEIGHT weight
Weights the text in different ways. Requires CSSSTYLE.
Variable: ol_textweight.

CAPTIONSIZEUNIT unit
The unit to be used when specifying caption text sizes. Requires CSSSTYLE.
Variable: ol_captionsizeunit.

CAPTIONDECORATION decoration
Decorates the caption text with underlines etc. Requires CSSSTYLE.
Variable: ol_captiondecoration.

CAPTIONSTYLE style
Styles the caption text with italics etc. Requires CSSSTYLE.
Variable: ol_captionstyle.

CAPTIONWEIGHT weight
Weights the caption text in different ways. Requires CSSSTYLE.
Variable: ol_captionweight.

CLOSESIZEUNIT unit
The unit to be used when specifying close text sizes. Requires CSSSTYLE.
Variable: ol_closesizeunit.

CLOSEDECORATION decoration
Decorates the close text with underlines etc. Requires CSSSTYLE.
Variable: ol_closedecoration.

CLOSESTYLE style
Styles the close text with italics etc. Requires CSSSTYLE.
Variable: ol_closestyle.

CLOSEWEIGHT weight
Weights the close text in different ways. Requires CSSSTYLE.
Variable: ol_closeweight.

5.
Miscellaneous

CAPTION title
Sets the caption of the popup.
Variable: ol_cap.

CLOSETEXT text
Replaces the text "Close" with something else.
Variable: ol_close.

NOCLOSE
Doesn't display the text "Close" on stickies with caption.
Variable: ol_close.

INARRAY id
Tells overLIB to read the text from the ol_texts array, located in overlib.js (or on page). This parameter can be used instead of text. Example: overlib(INARRAY, 1);
Variable: ol_texts.

CAPARRAY id
Tells overLIB to read the caption from the ol_caps array.
Variable: ol_caps.

FUNCTION functionname
Calls the specified function and takes the return value as the text that should be displayed in the popup. The function is called when the overLIB command parser runs.
Variable: ol_function.

STATUS text
Sets the text in the browsers status bar to text.
Variable: ol_status.





On this page
Introduction
Behaviour, Positioning and Sizes
Colors, Fonts and Images
Cascading Style Sheets
Miscellaneous


Contributors
Erik Bosrup


Status
overLIB version: 3.51
Document version: 1.1
Created: 2001-07-08
Changed: 2002-11-01


Amazon.com
cover
Web Content Management
Russell Nakano
Only $10.95!
(Prices May Change)
Privacy Information


Copyright Erik Bosrup 2001-2002. All rights reserved.