The <ITEM-LIST> tag allows you to insert drop-down menus of items (each item being a DNA article, a DNA Member, or a website). Choosing a link will jump to that destination, either in the same window or a new one, depending on the setting of the radio button.

This tag does not form part of Approved GuideML.

Syntax and Usage

Optional attributes are shown in italics, and the vertical bar character | denotes a choice, so H2G2|BIO|HREF means one of H2G2, BIO or HREF.

<ITEM-LIST NAME="...unique name...">

<FIRSTITEM>...first item name...</FIRSTITEM>
<ITEM H2G2|BIO|HREF="...article/userid/url...">...text...</ITEM>

<ITEM>...</ITEM>
...

</ITEM-LIST>

This tag inserts a drop-down menu into your article. The tags work as follows:

• Each <ITEM-LIST> menu in your article must be given a unique name within that article (but you can use the same names in different articles). The ...unique name... argument is that name, and it must not contain spaces. This name is simply used to ensure that the JavaScript generated by the tag works properly; it doesn't have any other relevance.

• The optional <FIRSTITEM> tag can be used to define what is displayed in the menu before a choice is made; the ...first item name... argument is what is shown. The default used if there is no <FIRSTITEM> tag is Please choose one.

• Each <ITEM> tag represents an item in the menu. <ITEM> tags use the same attributes as the <LINK> tag - H2G2, BIO or HREF - to determine the destination for each item in the menu. The ...text... part is what is displayed in the menu.

• You should put in an <ITEM> tag for each item you want to appear in the menu, and they are displayed in the menu in the order in which they appear within the <ITEM-LIST> block.

Known Issues

None.

Example One

Here's a menu with a <FIRSTITEM> tag and five <BIO> arguments to the <ITEM> tag:

Example Two

Here's a menu where you can choose from three items:

Further Information

• The DNA GuideML Clinic