Creating an element tag
The Element tag is used to reference an element within a presentation template or element design.
About this task
This is the format of an element tag:
[Element type=" " context=" " name=" " key=" " format=" " link=" " separator=" " htmlencode=" " awareness=" " start=" " end=" " ]
To create an element tag:
Procedure
What to do next
Tag parameters | Details |
---|---|
name=" " | If you specify name="./itemName", the actual path is not resolved until the item is rendered. This takes slightly longer to resolve than specifying the path to the item. |
format=" " | This parameter is optional and can only be used
with some element types:
|
link=" " | The link parameter is used to define the type
of link created by the element tag:
Contextual linking:
Contextual linking is used so that when content is linked from another site, the link is rendered relative to the current site if possible. It can only be used if context=current or context=autofill. |
separator=" " | This is used when referencing an option selection or user selection element. It is used to define what text or code is rendered between each selection displayed in an option selection or user selection element. For example, to add a line break between each selection, you would use separator="<br>". If not defined, a comma is placed between each selection when rendered. |
htmlencode=" " | If htmlencode="true" the reserved HTML characters
in text, short text and option selection elements are converted into
character entities. For example, '<' is converted to '<'.
This is useful if you would like to prevent users adding malicious
code, or if you want to prevent users changing the look and feel of
their text using HTML. If not specified, the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is used. By default, this property is set to true. |
awareness=" " | If awareness="true" then user names are displayed
using the people awareness features. These features display user names
as hyperlinks that allow users to contact people with whom they might
want to work. Wherever person links appear, users can click the link
to display a menu of actions for collaborating (contacting and working)
with the person named by the link. If you, as administrator, have
also configured an IBM® Sametime® server
to work with WebSphere® Portal,
person links indicate whether a person is active, away, offline, or
in a Do Not Disturb state. People awareness only works in content rendered using either a local or remote rendering portlet. If not specified, then awareness="false" and people awareness is not used. |
start=" " end=" " |
The start and end attributes are used to wrap the data returned by a tag within other tags, such as HTML. These attributes are not mandatory. |