tree menu eMenuTree: Options


I. Drop-down menus

A. "Use drop-down menus" check box

By default, eMenuTree writes tree menus .  If you want drop down tree menus , check the "Use drop down menus " option.

B. "Main menus open downward" check box

By default, drop down tree menus open to the right and downward.  If you want main menus to open directly downward, check the "Main menus open downward" option.  For other options see "Advanced tools > Positioning drop down menus ".

C. "2nd menu (and above) main menus open upward" check box

This is useful if you want to put a second menu (emenu02.js) at the bottom of the page.  To write emenu02.js use "Write extra menu" which is in the "Run / tools" menu.

II. Formatting the tree menu

A. Left indent of main folder in pixels

The number of pixels to indent a main folder.  This will give some padding between the edge of the page or the right hand side of the left column and the tree menu.  This option only affects click-to-open tree menus.

B. Left indent of subfolders in pixels.

This is the amount to indent each subfolder from its parent folder (an important value).  Too large a number will move subfolders too far to the right.  Too small a number will line subfolders up almost directly under their parents.  This option only affects click-to-open tree menus.

C. Tree menu background color

The color to put behind your menu Tree.  Selecting a color here highlights your tree menu and set it off from the rest of the page.  This works well with click-to-open tree menus.

D. "Use mouse over and mouse out in the tree menu." check box

Check this box to use mouse over and mouse out in a tree menu.  Your Cascade Style sheet must contain selectors .mainFolderLineMouseOver, .subFolderLineMouseOver, and .linkLineMouseOver.  The default CSS file contains:

.linkLineMouseOver {
    color : red;
}

.mainFolderLineMouseOver {
    color : red;
    text-decoration : none;
}

.subFolderLineMouseOver {
    color : red;
    text-decoration : none;
}

E. "No line breaks in folder / link names" check box

This option places "NOBR" tags around the folder and link names in your tree menu.  It tells the browser not to add a link break in the middle of the name.  This option is recommended only if your folder and link names are all short.

F. "Begin all project page links with collapsed trees" check box

By default, when a user links from one tree menu page to another, the tree menu will remain open.  If you check this box, the new page will begin with the tree menu completely collapsed.  This box is normally checked when the tree menu is placed at the top of the page.

G. "Top level links use .mainFolderLine CSS class" check box

By default, links that are on the outer most branch of the tree use .linkLine and .linkLineMouseOver.  Check this option to change this to .mainFolderLine and .mainFolderMouseOver.  (Both main folders and top level links will still be in a .mainFolderBox division.)

H. "Center tree menu table on page" check box

The tree menu is stored in a table.  This check box centers this table on the page.  If you use this option, you will also want to set the table width (the next option) and perhaps set the width of each column in the tree.

I. "Set the tree menu table width"

The tree menu is stored in a table.  This check box sets the table width.  If you use this option, you may also want to set the "Center tree menu table" option and perhaps set the width of each column in the tree.

III. Project options

A. "Treat Netscape 6 as a generic browser" check box

The generic browser version of eMenuTree loads quickly even for very long tree menus .  For more information about the different browsers and how they are handled by eMenuTree see Technical help>browsers.

B. "Treat Internet Explorer as a generic browser" check box

By default, IE 4,5, and 6 run the W3C browser tree menu code.  Check this box to treat them as generic browsers.

C. "Use ASP files and server side include" check box.

If you check this box, eMenuTree will write tree menus to the file emenu.asp.  The default home page becomes ehomepage.asp.  All HTML files with tree menus must have the extension .asp.  You must be using a server that supports Microsoft's Active Server Pages.  To insert menus into an HTML file you must use:

<!-- #Include file="emenu.asp" -->

D. "Use absolute links to files on hard disk" check box

This option affects page links that link to a file on your hard drive.  By default, these links will be relative links.  This is what you need if you are going to put your tree menu pages on a server.  However, if you only going to use your tree menus on your hard drive, for can choose to link directly to the file.  The link will be to "C:/...".  The advantage of this is that the file does not need to be in your web folder.  You can link directly to files anywhere on your hard drive.  If you choose this option, you may also use eMenuTree's insert multiple links options to link to an entire folder that is not a subfolder of your web folder.  (The most powerful feature: you can use an ASP tree menu that reads the files from any folder on your hard drive into a click-to-open or drop down tree menu as the tree menu is loading into the browser.)

E. "Include columns in the site map file" check box

If this is checked, eMenuTree will insert the columns of your tree menu into the site map file.

F. Transforming the URL with 'function cnv(ju,k)'

This option requires some knowledge of javascript and the internal workings of eMenuTree, and is not recommended for beginners.

Most page link options contain either javascript or a URL.  Suppose you find yourself entering the same code a multitude of times.  You can write a javascript function, 'cnv(ju,k)', to ask the browser to insert this code for you.  The variable 'ju' is the javascript or the URL.  The variable k helps you pick out which links to modify.  k is a string.  It will contain 'w' if you chose the "Link to a URL" option, 'e' if the link is to an external window, 'i' if the link is to the same window, 'r' if the link is to the content frame of a frameset, and 'j' if it is a javascript link.  Entering

function cnv(ju,k){if(k.indexOf('w')>-1){ju='http://www.'+ju}; return ju}

would tell the browser to add "http://www." to the front of all your "Link to a URL" links.  If you have a lot of links to the WWW, this will reduce the size of your tree menu files.

As with most places in eMenuTree, you should not use double quotes.  Also, since the site map file does not use javascript, if you use this option and the site map file, you must edit the site map file yourself.

G. File / URL to preview

This option allows you to tell eMenuTree which file or URL to preview.  In most cases you will want this to be your home page.  If your home page is not a frameset, you will want to insert the tree menu into it.  You can do this using the "Edit preview file" button.

If you leave these options blank, eMenuTree will preview ehomepage.htm, or if you are using frames, eframeset.htm.

IV. Program options

The names of these options should be clear enough.  They are "program" options because they are not stored in your project file.  They will go into effect when you check them, and will remain in effect for all projects until you uncheck them.