Package ro.sync.exml.workspace.api.editor.page.ditamap

Class DITAMapNodeRendererCustomizer

java.lang.Object

ro.sync.exml.workspace.api.node.customizer.XMLNodeRendererCustomizer

ro.sync.exml.workspace.api.editor.page.ditamap.DITAMapNodeRendererCustomizer

All Implemented Interfaces:

Extension

@API(type=EXTENDABLE,
     src=PUBLIC)
public abstract class DITAMapNodeRendererCustomizer
extends XMLNodeRendererCustomizer

Node renderer customizer specific for the DITA Maps Manager.

Since:

18.1

Constructor Summary

Constructors

Constructor	Description
DITAMapNodeRendererCustomizer()

Method Summary

Modifier and Type	Method	Description
String	customizeComputedTopicrefTitle(AuthorNode topicref, AuthorNode targetTopicOrMap, String defaultComputedTitle)	Customize the default computed topicref title.
String	customizeRenderedTopicrefTitle(AuthorNode topicref, String defaultRenderedTitle)	Customize the default rendered topicref title.
String	getDescription()
BasicRenderingInformation	getRenderingInformation(NodeRendererCustomizerContext context)	Override this to provide extra rendering information.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DITAMapNodeRendererCustomizer

public DITAMapNodeRendererCustomizer()

Method Details

customizeComputedTopicrefTitle

public String customizeComputedTopicrefTitle(AuthorNode topicref,
 AuthorNode targetTopicOrMap,
 String defaultComputedTitle)

Customize the default computed topicref title. After the API returns the modified title, the title will be cached for the current referenced topic. So this method is called usually once for every individual referenced topic. This kind of method is useful for example if you want to get some significant attributes (maybe profiling attributes) from the topic's root element and display them in the title.

Parameters:

topicref - The topicref node present in the DITA Maps Manager

targetTopicOrMap - Oxygen already parsed the document referenced via topicref, computed a title and this parameter gives you access to the root element of the parsed topic.

defaultComputedTitle - The default title computed by Oxygen

Returns:

The customized topic title.

customizeRenderedTopicrefTitle

public String customizeRenderedTopicrefTitle(AuthorNode topicref,
 String defaultRenderedTitle)

Customize the default rendered topicref title. This method is called very often, each time the tree or part of the tree is rendered. It is also called separately if there are multiple topicrefs pointing to the same topic. This kind of method is useful for example if you want to number topicrefs displayed in the DITA Maps Manager view based on depth.

Parameters:

topicref - The topicref node present in the DITA Maps Manager

defaultRenderedTitle - The default title which will be rendered by Oxygen

Returns:

The customized topic title.

Since:

21

getRenderingInformation

public BasicRenderingInformation getRenderingInformation(NodeRendererCustomizerContext context)

Override this to provide extra rendering information. The context is an instance of DITAMapNodeRendererCustomizerContext which has more information about topicrefs.

Specified by:

getRenderingInformation in class XMLNodeRendererCustomizer

Parameters:

context - The node context(contains information like node name, namespace and attributes).

Returns:

The rendering information. If the returned value is null then the default node rendering will be used.

See Also:

• XMLNodeRendererCustomizer.getRenderingInformation(ro.sync.exml.workspace.api.node.customizer.NodeRendererCustomizerContext)

getDescription

public String getDescription()

Returns:

The description of the extension.

See Also:

• Extension.getDescription()