Edit online

Customizing XML Node Rendering

You can use this API extension to customize the way an XML node is rendered in the Outline view in Author mode, breadcrumb navigation bar in Author mode, Outline view in Text mode, Content Completion Assistant window, or DITA Maps Manager view.

Note: Oxygen XML Author uses XMLNodeRendererCustomizer implementations for the following frameworks: DITA, DITA Map, DocBook 4, DocBook 5, TEI, XHTML, XSLT, and XML Schema.

There are two methods to provide an implementation of ro.sync.exml.workspace.api.node.customizer.XMLNodeRendererCustomizer:

As a part of a bundle, returning it from the createXMLNodeCustomizer() method of the ExtensionsBundle associated with your document type in the Document type configuration dialog box (Extensions bundle field in the Extensions tab).
As an individual extension, associated with your document type in the Document type configuration dialog box (XML node renderer customizer field in the Individual extensions section of the Extensions tab).

Support for Retina/HiDPI Displays

To support Retina or HiDPI displays, the icons provided by the XMLNodeRendererCustomizer should be backed up by a copy of larger size using the proper Retina/HiDPI naming convention.

For example, for the <title> element, if the XMLNodeRendererCustomizer returns the path ${framework}/images/myImg.png, then to support Retina images with a scaling factor of 2, an extra file (myImg@2x.png)should be added to the same images directory (${framework}/images/myImg@2x.png). If the higher resolution icon (the @2x file) does not exist, the normal icon is scaled and used instead.

For more information about using Retina/HiDPI images, refer to the Using Retina/HiDPI Images in Author Mode section.

Note: The complete source code for framework customization examples can be found in the oxygen-sample-framework module of the Oxygen SDK, available as a Maven archetype on the Oxygen XML Author website.