dropDownNodes - Drop Down Menu Node

Provides selection data for a dropdown menu.

Category

basics

Syntax

<xe:this.dropDownNodes>
	<xe:basicContainerNode attributes>content</xe:basicContainerNode> |
	<xe:basicLeafNode attributes>content</xe:basicLeafNode> |
	<xe:beanTreeNode attributes>content</xe:beanTreeNode> |
	<xe:dominoViewEntriesTreeNode attributes>content</xe:dominoViewEntriesTreeNode> |
	<xe:dominoViewListTreeNode attributes>content</xe:dominoViewListTreeNode> |
	<xe:loginTreeNode attributes>content</xe:loginTreeNode> |
	<xe:pageTreeNode attributes>content</xe:pageTreeNode> |
	<xe:repeatTreeNode attributes>content</xe:repeatTreeNode> |
	<xe:separatorTreeNode attributes>content</xe:separatorTreeNode> |
	<xe:userTreeNode attributes>content</xe:userTreeNode>
	...
</xe:this.treeNodes>
Table 1. Properties for xe:basicContainerNode
Property Description
<xe:this.children>nodes</xe:this.children> Child nodes with content the same as <xe:this.treeNodes>.
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
href="href" Relative or absolute URL to which can be used as a link.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
onClick="script" A script that executes if the node is clicked and href is empty.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
submitValue="text" Value submitted by the parent control if this node is selected. Use context.getSubmittedValue in an events.action area or XSP.getSubmitValue() in an events.script area to refer to the submitted value.
transparent="true|false" Whether the node shows its children as nodes.
title="text" Advisory title for assistive technologies.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 2. Properties for xe:basicLeafNode
Property Description
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
href="href" Relative or absolute URL to which can be used as a link.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
onClick="script" A script that executes if the node is clicked and href is empty.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
submitValue="text" Value submitted by the parent control if this node is selected. Use context.getSubmittedValue in an events.action area or XSP.getSubmitValue() in an events.script area to refer to the submitted value.
transparent="true|false" Whether the node shows its children as nodes.
title="text" Advisory title for assistive technologies.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 3. Properties for xe:beanTreeNode
Property Description
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
nodeBean="name" Name of class or managed bean that provides the node or node list. Should implement the ITreeNode interface.
Table 4. Properties for xe:dominoViewEntriesTreeNode
Property Description
databaseName="name" Name of a Domino database..
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
href="href" Relative or absolute URL to which can be used as a link.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
keys="keys" Key or array of keys that filter a view based on sorted column values as in getAllDocumentsByKey.
keysExactMatch="true|false" Whether keys require an exact match. Defaults to a partial match.
label="text" Text displayed by the node.
labelColumn="name" Name of a view column to display as the node label.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
onClick="script" A script that executes if the node is clicked and href is empty.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
submitValue="text" Value submitted by the parent control if this node is selected. Use context.getSubmittedValue in an events.action area or XSP.getSubmitValue() in an events.script area to refer to the submitted value.
title="text" Advisory title for assistive technologies.
var="name" Name of a request scope variable where the view entry object is made available.
viewName="name" Name of a Domino view.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 5. Properties for xe:dominoViewListTreeNode
Property Description
databaseName="name" Name of a Domino database..
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
filter="regexp" Regular expression to filter the view or folder names to be displayed.
folders="true|false" Whether folders are processed. Defaults to true.
href="href" Relative or absolute URL to which can be used as a link.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
onClick="script" A script that executes if the node is clicked and href is empty.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
submitValue="text" Value submitted by the parent control if this node is selected. Use context.getSubmittedValue in an events.action area or XSP.getSubmitValue() in an events.script area to refer to the submitted value.
title="text" Advisory title for assistive technologies.
var="name" Name of a request scope variable where the view entry object is made available.
views="true|false" Whether views are processed. Defaults to true.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 6. Properties for xe:loginTreeNode
Property Description
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
title="text" Advisory title for assistive technologies.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 7. Properties for xe:pageTreeNode
Property Description
<xe:this.children>nodes</xe:this.children> Child nodes with content the same as <xe:this.treeNodes>.
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
pageName="name" Name of XPage. Generates a link and sets the selection flag if no selection formula is present.
queryString="text" Query string appended to the URL.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
selection="regexp" Regular expression for selecting the item.
title="text" Advisory title for assistive technologies.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 8. Properties for xe:repeatTreeNode
Property Description
<xe:this.children>nodes</xe:this.children> Child nodes with content the same as <xe:this.treeNodes>.
indexVar="name" Request scope variable name where the current repeat index is made available.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
value="text" Value up to which items are repeated.
var="name" Request scope variable name under which the current object is made available.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 9. Properties for xe:separatorTreeNode
Property Description
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
rendered="true|false" Whether the node is visible on the rendered page.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.
Table 10. Properties for xe:userTreeNode
Property Description
enabled="true|false" Whether the node is enabled. Defaults to true. For example, displays a node as text instead of a link, or a button is grayed out.
image="name" Name of image displayed by the node.
imageAlt="text" Alternate text if the image cannot be viewed.
imageHeight="50%|30px|10em|2cm|auto|inherit" Image height.
imageWidth="50%|30px|10em|2cm|auto|inherit" Image width.
label="text" Text displayed by the node.
loaded="true|false" Whether the tag instance should be created when the page is loading. Defaults to true.
rendered="true|false" Whether the node is visible on the rendered page.
role="text" Text that can be used by assistive technologies to determine the purpose of the node.
selected="true|false" Whether the node appears as selected when it is loaded.
title="text" Advisory title for assistive technologies.
userField="name" Name of field for displaying the user data. Depends on the data provider. Defaults to displayName. For Domino, you can use commonName, abbreviatedName, canonicalName, and so on.
style="style(s)" CSS styles to be applied.
styleClass="class(es)" CSS style classes to be applied.

Usage

In Design mode, click All Properties and look for treeNodes under basics.

Examples

This example demonstrates a number of widgets.
<xe:widgetContainer id="widgetContainer1" titleBarText="Title Bar">
		This widget container has a title bar.
</xe:widgetContainer>
<xe:widgetContainer id="widgetContainer2"	titleBarHref="https://www.google.com/" titleBarText="google">
		This widget container has title bar that you can click and go to.
</xe:widgetContainer>
<xe:widgetContainer id="widgetContainer3" titleBar="false">
		This widget container does not have a title bar.
</xe:widgetContainer>
<xe:widgetContainer id="widgetContainer4" type="sidebar">
		This widget goes to another page. The user clicks on
		"Actions" in the title bar and a page selection
		drops down.
		<xe:this.dropDownNodes>
			<xe:pageTreeNode label="main" page="/main.xsp"></xe:pageTreeNode>
			<xe:pageTreeNode page="/mainview.xsp" label="mainview"></xe:pageTreeNode>
		</xe:this.dropDownNodes>
</xe:widgetContainer>