section:use

Sets the "current" section to a different section within this tag. All section tags that relate to the current section in the body of this tag will use the specified section instead of any previous current section. Normally, the default-section is set by the template mechanism, but for a portion of JSP it may be desirable to use a different section. This tag will make any tags within its body use this section. One of section or sectionName must be specified. The section will be also be available using the "apisection" request attribute.

The section:use tag does not alter the default presentation pool. Tags that operate on the pool, rather than on the section (e.g. <template:element>), will not work as expected unless the <template:defaultPresentationPool> is used as well.

Syntax

<section:use
   name="..."?
   property="..."?
   section="..."?
   sectionId="..."?
   sectionIdInt="..."?
   source="..."?
   sourceId="..."?
   uniqueName="..."?>
   ...
</section:use>

Attributes

section

A scriptlet that returns the section object to be used as the new "default" section.

sectionId

Optionally,specify Section ID (a numeric string) of an attribute that contains a Section object to be used as the new "default" section.

uniqueName

The unique name of the section that is to be the new "default" section. This section will be loaded from the current default publication.

name

The name of an attribute that contains a Section object to be used as the new "default" section.

property

Specifies the name of the property to get the wanted Section on the bean specified by name. It makes no sense specifying property if name is not set.

This value may be a simple, indexed, or nested property reference expression. If not specified, we expect that the bean specified by name is a Section.

source

Source of the section to set as "default" section. This attribute can not be used without the sourceId attribute.

sourceId

SourceId used to identify the section to be set as "default" section. This attribute can not be used without the source attribute.

sectionIdInt

The Section ID (an int) of an attribute that contains a Section object to be used as the new "default" section.