onlyonce JavaServer Page tag
Use the
onlyonce
JSP tag to indicate that text within the body of the tag is to be included in the stream processing output only the first time that an onlyonce tag of that name is found.
This tag is primarily useful in complex HTML streams to prevent multiple definitions of JavaScript functions.
When to use
When entering HTML source code directly into the
HTML
tab of a control rule (or similar form), you can minimize the size of the resulting HTML document with the
<pega:onlyonce >
and
<pega:static >
tags. See
Including only one copy of JavaScript code
in
More about control rules.
Example
For example, this tag is named Alpha.
<!-- define scripts -->
<pega:onlyonce name="Alpha" >
The work item id is <pega:reference name=".pyID">
</pega:onlyonce >During stream processing, if another onlyonce tag named Alpha appears, the body of the second (and later) tags are skipped over and not processed.
Complete syntax
In the syntax presentations below:
- JSP delimiters <pega: and </pega: mark the start and end of the tag.
- Replace any text in italics with your choice of value of that type.
<pega:onlyonce name="name" >
HTML, XML or JavaScript code to process only once
</pega:onlyonce >
The
name
attribute is required.
| Attribute | Description |
|---|---|
name
|
Set the name attribute to an arbitrary non-blank text value. Case is significant. During stream processing, second and later appearances of an
onlyonce
tag with this name cause the body of the tag to be treated as a comment, contributing nothing to the stream results.
|