Reference Components

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

Reference Components

The Component tag is used to reference the content of a component within a presentation template or element design.

<Component name=" " format=" " separator=" " start=" " end=" " />
<Component Opens a library component tag.
name=" " Enter the name and library of the component being referenced. For example, name="library/item". To use the library specified in the URL of the current page, use name="./item".
start=" "
end=" "

The start and end attributes are used to wrap the data returned by an IBM^® Workplace Web Content Management™ tag within other tags, such as HTML. These attributes are not mandatory. See the Using start and end attributes topic for more information on using these attributes.
format=" " This parameter is optional and can only be used with some component types:

When referencing an image component:

Use format="url" to only render the URL of an image component.

Use format="tag" to render a complete image tag. The image will be displayed on the rendered page. This is used by default if no format is specified.

When referencing a link component:

Use format="url" to only render the full URL of a link component.

Use format="path" to only render the site path of a link component. For example, site/sitearea/content .

Use format="tag" to render a complete link tag. This is used by default if no format is specified.

When referencing number or date components:

In this case, the format is used to specify the display format of dates and numbers. See Setting parameters to format dates and Note on formatting numbers for further information.

separator=" " This only used when referencing a user selection component. It is used to define what text or code will be rendered between each selection. For example, to add a line break between each selection, you would use separator="<br>" . If not defined, a comma will be placed between each selection when rendered.
/> Closes a Web Content Management tag

Parent topic:
Referencing elements

<Component name=" " format=" " separator=" " start=" " end=" " />
<Component	Opens a library component tag.
name=" "	Enter the name and library of the component being referenced. For example, name="library/item". To use the library specified in the URL of the current page, use name="./item".
start=" " end=" "	The start and end attributes are used to wrap the data returned by an IBM^® Workplace Web Content Management™ tag within other tags, such as HTML. These attributes are not mandatory. See the Using start and end attributes topic for more information on using these attributes.
format=" "	This parameter is optional and can only be used with some component types: When referencing an image component: Use format="url" to only render the URL of an image component. Use format="tag" to render a complete image tag. The image will be displayed on the rendered page. This is used by default if no format is specified. When referencing a link component: Use format="url" to only render the full URL of a link component. Use format="path" to only render the site path of a link component. For example, site/sitearea/content . Use format="tag" to render a complete link tag. This is used by default if no format is specified. When referencing number or date components: In this case, the format is used to specify the display format of dates and numbers. See Setting parameters to format dates and Note on formatting numbers for further information.
separator=" "	This only used when referencing a user selection component. It is used to define what text or code will be rendered between each selection. For example, to add a line break between each selection, you would use separator="<br>" . If not defined, a comma will be placed between each selection when rendered.
/>	Closes a Web Content Management tag