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.