OpenCms JSP standard taglib
Tag display

Via this tag, you can render an XML content with a given formatter from inside a (formatter) JSP.

In particular, the tag is useful for rendering list items from within a list formatter. The tag can be configured to work for contents of different type - thus it also for lists of mixed resources.

Optionally, you can display edit points at the output. They facilitate similar editing functionality as <cms:edit>.

In the body of the <cms:display> two other tags can be used

• <cms:displayFormatter>

  Via this tag you can specify which formatters are used for which content types by the <cms:display>-tag. The choice can also be performed via the displayFormatters attribute (see the attribute's description below).

  If nothing is specified, the formatter with the highest rank, from within the formatters that have "Use as display formatter" enabled, is chosen.

• <cms:param>

  This tag, contrary to it's default purpose, is used to pass element settings.

  To pass a setting, write:

  <cms:param name="settingName">settingValue</cms:param>

  The setting values specified here, overwrite the values that are possibly passed from the settings of the surrounding formatter (see the attribute passSettings.



---

Tag Information
Tag Class	org.opencms.jsp.CmsJspTagDisplay
TagExtraInfo Class	None
Body Content	JSP
Display Name	None




Attributes
Name	Required	Request-time	Type	Description
passSettings	false	true	java.lang.String	If you use the tag inside a formatter that already has settings, you can pass these settings to the formatter used by the display tag.
settings	false	true	java.lang.String	Allows to set the element settings as a java.util.Map.
displayFormatters	false	true	java.lang.String	The attribute takes the value of one, or the value list of several, schema elements of type OpenCmsDisplayFormatter. Use it, if you choose the formatter of the displayed content via a content value in the surrounding (list) content. The display formatters can alternatively be specified via <cms:displayFormatter> tags, used in the body of cms:display. If not specified, the formatter with the highest rank, from within the formatters that have "Use as display formatter" enabled, is chosen.
containerType	false	true	java.lang.String	A container type used to select a formatter. When a content is to be displayed, and no formatter has been specified for its type, then if this attribute is set, an active formatter for its resource type which matches the given container type will be selected (formatters with higher rank will be prioritized).
editable	false	true	java.lang.String	If set to true, the "Edit" button is added to the edit buttons. Default: false
value	true	true	java.lang.String	Site path or structure id of the XML content that should be rendered via the <cms:display>-tag.
create	false	true	java.lang.String	If set to true the "Create" option is added to the edit buttons. Newly created resources have the same type as the resource displayed.
creationSiteMap	false	true	java.lang.String	The location where newly created contents are stored is read from sitemap configurations. creationSiteMap specifies the sitemap from which the configuration should be used. Provide the (site-relative) path to a folder in the (sub)sitemap. Default: The (sub)sitemap of the currently requested URI.
delete	false	true	java.lang.String	If set to true, the "Delete" option is added to the edit buttons. Default: false
postCreateHandler	false	true	java.lang.String	The fully qualified class name of a org.opencms.file.collectors.I_CmsCollectorPostCreateHandler that is called when a new resource is created via the tag.
baseUri	false	true	java.lang.String	Change the URI of the request context used for formatter lookup to the provided value. This is useful when using the display tag in JSPs called via AJAX and you want to use the default display formatter for the current page.
cacheable	false	true	java.lang.String	Flag to indicate if the included file should be cacheable in the Flex Cache. Default: "true".
uploadFolder	false	true	java.lang.String	The folder to upload binary folders to. If not set, upload for binary files is disabled.




Variables

No Variables Defined.




Overview   Library    Tag    Help
	FRAMES   NO FRAMES

---

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.