C H A P T E R  31

treeNodeHandle


<jato:treeNodeHandle>

Denotes a visual control that end users can select to toggle the expanded/collapsed state of a particular tree node. This tag will be rendered as an HTML <a href="..." >...</a> element, with an implicit URL generated by the tag and handled by the parent tree view automatically when activated.

This tag may contain body content. This content will be included between the <a> and </a> tags of the rendered element and thus appear as the visible, clickable HREF element.

This tag is only valid when ultimately enclosed by a treeView tag. This tag may be directly parented by a treeNode tag.

Example:

...

 

<jato:treeNodeHandle>

<img src="handle.gif">

</jato:treeNodeHandle>

 

...

Attribute Name

Description

Notes

accessKey

Assigns an access key to the rendered HTML element. In general, the access key should be included in label text or wherever the access key is to apply.

RTExpr

disabled

Valid values: "true" or "false"

Disables the HTML control for user input.

  • Disabled controls do not receive focus
  • Disabled controls are skipped in tabbing navigation

If not specified, "false" is assumed.

RTExpr

elementId

Assigns a name to an element. This name must be unique in an HTML document. Please note, this corresponds to the HTML "id" attribute. It has no specific meaning to the JATO framework.

The id attribute has several roles in HTML:

  • As a style sheet selector
  • As a target anchor for hypertext links
  • As a means to reference a particular element from a script

RTExpr

extraHtml

Arbitrary HTML that will be rendered just prior to the closing ">" of this HTML element

RTExpr

queryParams

Specifies an arbitrary number of name value pairs which will be appended to the HREF's query string.

The name value pairs should follow the format "name=value", where value is URL encoded by the JSP author as needed. Additional name value pairs must be delimited by the '&' character.

Example:

queryParams="fname=Mike&lname=Jones"

RTExpr

style

CSS styles to be applied to this HTML element.

RTExpr

styleClass

CSS stylesheet class to be applied to this HTML element.

RTExpr

tabIndex

Specifies the position of the current element in the tabbing order for the current document. This value must be a number between 0 and 32767.

 

title

Offers advisory information about this element.

RTExpr

trim

Valid values: "true" or "false"

A value of "true" specifies that the tag content should be trimmed of all leading and trailing whitespace. A value of "false" preserves the whitespace.

If not specified, "true" is assumed.

 

 

This tag also supports the following JavaScript events:

onBlur, onChange, onClick, onDblClick, onFocus, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onSelect