Defines either a new search list, or a new search list item. Providing a value for the id attribute names the list so that it can be referenced from other declarations.
For example, in the following code example, the first instance of the <searchList> tag has the id attribute set to home-search. Therefore, it starts a new search list with this ID. The subsequent instances of the <searchList> tag do not set the id attribute, so they define new items in the list.
Starting a Search List and Defining Items - XML Example
<!-- This line starts the home-search search list declaration. This defines the set of links that appear under the "Search for..." heading on the home page. The id attribute provides the name for the search list that can be used to refer to the list from other declarations.-->
<searchList id="home-search" template="searchList.xsl">
<!-- This tag defines the first item on the list - a link to the People search form.-->
<searchList>
<label labelClass="squarebullettext"><li> People</label>
<url>$(PAGE_SERVER)/advanced-searches?defaultItemId=item5001&
usePersistence=false&proxyAccount=$(proxyAccount)</url>
</searchList>
... <!-- more search list items would appear here before the closing tag that ends the entire home-search list. -->
</searchList>
This element can contain the following elements:
| Element | Description |
|---|---|
| column Tag | Defines a column that contain search list items. A search list can display links in multiple columns. |
| label Tag | Specifies the text that appears in the search list item. Also controls display characteristics using the CSS classes defined in the Web Client style sheets. |
| description Tag | Provides a description of the search list item. |
| url Tag | Specifies the destination of the search list link. If a search list item does not have a URL specified, it is displayed as a text label rather than a link. |
| searchList Tag | Defines an item within the search list. This element can create either links or heading items. |
Attributes
The <searchList> element has the following attributes:
Attributes for <searchList>
| Attribute | Description | Possible Values |
|---|---|---|
| id | Defines a name for the search list. If this is specified for the element, then you can refer to the list from other declarations. | Any text name. Do not include spaces in the name. |
| template | ||
| show | Specifies whether or not the search list item should appear. Normally, you set this to a variable that resolves to True or False.
| True - the item appears. False - the item does not appear. |