formatter

toc
<mm:formatter> This tag performs XSL and other transformations.
see alsoxslt | param
attributes
  • xslt
    Path to the XSLT file which must, relative to the current JSP file. If you want to use default MMBase XSLT's, then you can prefix by `mm:', and searching will begin in the mmbase configuration directory.
  • format

    A few transformations are predefined in MMBase. If they are XSL transformations then you can put your extensions in e.g. xslt/2xhtml.xslt. This xslt can be extended from the `basic' xslt by beginning it with: <xsl:import href="mm:2xhtml.xslt" />.

    So basically, when you do specify the format attribute there can happen two different things:

    • It is a shortcut for certain values for the `xslt' attribute. E.g. format="xhtml" is shorthand for xslt="xstl/2xhtml.xslt".
    • It give access to certain java functionality present in the formatter tag's implementation. It is e.g. senseless to escape XML with a XSL style sheet, when it can be done so easily in Java.


    none No transformation done by this tag itself. Simply writes out the body, it considers the 'escape' attribute though, so this can be used to apply escapers to body-text.
    xhtmlAn XSLT. Transforms nodes or fields to an XHTML presentation.
    richAn XSLT. Transforms mmxf fields to simple text only presentation.
    presentxmlAn XSLT. Tries to make a nice presentation of XML in XHTML, with colors and so on.
    codeAn XSLT. Doesn't work well. To present taglib code.
    escapexml Escapes characters which make something XML. This way you can easily present XML in XHTML pages. This option is obsoleted by the 'escape' attributes of writers.
    escapexmlpretty Similar to escapexml, but the XML is nicely formatted for human consumption first. This required the XML to be valid, otherwise you get an exception.
  • options
    You can give options to the transformation. Parameters can be done with 'referids' or mm:param sub-tags.
  • referids (since: MMBase-1.8)
    Similar to `referids' attribute of mm:url
    see: referids attribute of url
  • wants

    This tags can communicate in two ways with its body. Normally the default way will do what you expect, but occasionally it can be that it doesn't. then this attribute will come in handy.

    If you don't understand this attribute, then don't worry. You will when you need it.


    stringMeans that the tag simply takes its body as a string.
    DOM Means that the tag must contains sub-tags, which can communicate themselves to this formatter tag and are put in a DOM Document (created by org.mmbase.bridge.xml.Generator)
    default

    This is the default, and means that the way in which the formatter tag get its information is determined smartly.

    This means that it is `DOM' iff the body contains only tags which can communicate themselves to this tag, or don't produce output themselves (are not writer tags) and the `format' is an XSLT-format.

  • namespaceaware (since: MMBase-1.8)
    Whether the generated DOM (if that happens) must be created with the name-space http://www.mmbase.org/objects. Defaults to true.
contextwriter attributes
contextreferrer attributes
contextreferrer attributes
writer attributes