p:r JavaServer Page tag
tag to display the values of properties, to allow users
to enter values for properties, and to insert parameter values. (The p:r tag provides identical
capabilities as the reference tag, but requires less typing.)
For a full explanation of the reference tag, see JavaServer Page tags — Reference.
p:r rather than
pega:reference as the tag. As
n for name,
mode. In the syntax
- Square bracket characters
]define optional parts of the tag. Do not type the brackets.
- JSP delimiters <p:r and /> mark the start and end of the tag.
- Replace any text in italics with your choice of value of that type.
n attribute is required. The
m options are optional.
<p:r n="[propertyref]" [f="option"] [m="mode"]/>
Property name or symbol — n attribute
Enter a property reference or a dynamic reference to a variable in the current stream,
$page-message. For a list of these
keywords, see How to
reference properties indirectly.
Format — f attribute
Include the optional
f attribute to present the property using a control
rule other than the one referenced in the property definition. Identify another control rule
name within double quotes.
You can use the
f attribute only when the
is omitted or is set to
display. Additionally, the
attribute must explicitly identify a property, not a parameter or symbolic reference.
Presentation — m attribute
m attribute controls additional facets of presentation and
processing. If you omit the
m attribute, the default value is
|block|| The same as |
You can't use the format attribute with m="block".
Instructs the system to use a control rule as read only, detectable as !
In releases before PRPC Version 5.4, the keyword
|Presents the property in update mode so that a user can enter, or select, a value for the property.|
| Useful when the result of the <pega:reference > is to become part of a
characters within the property value escaped to a backslash equivalent. No control
is applied. |
For example, assume the value of property MyProperty is
The output of stream processing is:
| Causes the value of the property to be masked from HTML processing. Use this
if the value may contain angle bracket characters or other HTML elements that are
not to be interpreted. |
When you save a stream rule that includes a reference tag with this mode, you may receive a security warning message:
For maximum security, do not use
In rare situations, your application may require mode="literal" in stream rules.
|Causes the <BR> tag received in an input textarea to be converted to a new line character.|
| On output, instructs the system to process the property to display HTML tags
without interpreting them. |
In addition, the system replaces each newline
character and <BR> with a space. It also performs the conversions listed for
| On output, converts the <,>, & and * characters to the corresponding
HTML entities ( |
m attribute examples
Property INFO has the value "Not <i>italic</i> or <b>bold</b>". The table shows the display that results from various settings for the m attribute, using an underscore to show added space characters.
|Tag||User display (read-only)|
|<p:r n="INFO" />|
|<p:r n="INFO" m="display"/>|
|<p:r n="INFO" m="text"/>|
|<p:r n="INFO" m="stream"/>|
|<p:r n="INFO" m="literal"/>|Previous topic onlyonce JavaServer Page tag Next topic Reference properties indirectly in JSP tags