NetUI Tag Library Documentation (Version 1.0.1)

netui-template
netui-template:setAttribute Tag

Sets a property value in a template page.

Syntax

<netui-template:setAttribute
    name="string_name"
    value="string_or_expression_value" >
    ... JSP content ...
</netui-template:setAttribute>

Description

Sets a property value in a template page.

The <netui-template:setAttribute> tag must have a parent <netui-template:template> tag.

The target placeholder is defined by a <netui-template:attribute> tag. For a value to be set in the placeholder, the <netui-template:attribute> and <netui-template:setAttribute> tags must have matching name attributes.

For example, a placeholder may be defined in the template.

In the template JSP page...

    <head>
        <title>
            <netui-template:attribute name="title"/>
        </title>
    </head>

Then content pages may set the value of this placeholder using the <netui-template:setAttribute> tag.

In a content JSP page...

    <netui-template:setAttribute name="title" value="myContentPage1.jsp"/>

The HTML rendered in the browser appears as follows.

Rendered HTML in the browser...

    <head>
        <title>
            myContentPage1.jsp
        </title>
    </head>
If the <netui-template:setAttribute> tag specifies no value to be set in the placeholder, then the <netui-template:attribute> tag's defaultValue will be used.
    <netui-template:attribute name="title" defaultValue="My Page"/>
The <netui-template:attribute> tag may also be used to define placeholders within JSP and HTML tags.

In the template JSP page...

    <td colspan="3" bgcolor="<netui-template:attribute name="headerColor" defaultValue="#ffffff"/>">

Attributes
name
Required: Yes  |   Type: String  |   Supports runtime evaluation / JSP Expression Language: Yes

The name of the attribute to set.
value
Required: Yes  |   Type: String  |   Supports runtime evaluation / JSP Expression Language: Yes

Sets the value of the attribute.

Example

Assume a <netui-template:attribute> tag defines a value placeholder within a <td> tag

    <td colspan="3" bgcolor="<netui-template:attribute name="headerColor" defaultValue="#ffffff"/>">

Now a content JSP page can control the background color of the <td>.

    <netui-template:setAttribute name="headerColor" value="lightgreen"/>
The HTML rendered in the browser will appear as follows.
    <td colspan="3" bgcolor="lightgreen">


Tag Information
Tag Classorg.apache.beehive.netui.tags.template.SetAttribute
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone