Class HtmlRenderer.MainNodeRenderer
java.lang.Object
com.vladsch.flexmark.html.NodeRendererSubContext
com.vladsch.flexmark.html.HtmlRenderer.MainNodeRenderer
- All Implemented Interfaces:
Disposable, LinkResolverBasicContext, LinkResolverContext, NodeRendererContext
- Enclosing class:
HtmlRenderer
private class HtmlRenderer.MainNodeRenderer
extends NodeRendererSubContext
implements NodeRendererContext, Disposable
-
Nested Class Summary
Nested Classes -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate AttributeProvider[]private Document(package private) HtmlIdGeneratorprivate LinkResolver[]private DataHolderprivate RenderingPhaseprivate List<PhasedNodeRenderer> private Map<Class<?>, NodeRenderingHandlerWrapper> private Set<RenderingPhase> private HashMap<LinkType, HashMap<String, ResolvedLink>> Fields inherited from class NodeRendererSubContext
doNotRenderLinksNesting, htmlWriter, renderingHandlerWrapper, renderingNode -
Constructor Summary
ConstructorsConstructorDescriptionMainNodeRenderer(DataHolder options, HtmlWriter htmlWriter, Document document) -
Method Summary
Modifier and TypeMethodDescriptionvoidpass node rendering to previously registered handlervoiddispose()@NotNull StringencodeUrl(@NotNull CharSequence url) @NotNull MutableAttributesextendRenderingNodeAttributes(@NotNull AttributablePart part, Attributes attributes) Extend the attributes by extensions for the node being currently rendered.@NotNull MutableAttributesextendRenderingNodeAttributes(@NotNull Node node, @NotNull AttributablePart part, Attributes attributes) Extend the attributes by extensions for the node being currently rendered.@NotNull Node@NotNull NodeRendererContextgetDelegatedSubContext(boolean inheritIndent) Creates a child rendering context that can be used to collect rendered html text of the previously registered node renderer.@NotNull Document@NotNull HtmlRendererOptionsGet the id attribute for the given node.@NotNull DataHolderGet the current rendering contextDataHolder.@NotNull RenderingPhase@NotNull NodeRendererContextgetSubContext(boolean inheritIndent) Creates a child rendering context that can be used to collect rendered html text.voidRender the specified node and its children using the configured renderers.(package private) voidrenderByPreviousHandler(NodeRendererSubContext subContext) voidrenderChildren(@NotNull Node parent) Render the children of the node, used by custom renderersprotected voidrenderChildrenNode(Node parent, NodeRendererSubContext subContext) (package private) voidrenderNode(Node node, NodeRendererSubContext subContext) @NotNull ResolvedLinkresolveLink(@NotNull LinkType linkType, @NotNull CharSequence url, Attributes attributes, Boolean urlEncode) Resolve link for rendering.Methods inherited from class NodeRendererSubContext
doNotRenderLinks, doNotRenderLinks, doRenderLinks, flushTo, flushTo, getDoNotRenderLinksNesting, getHtmlWriter, isDoNotRenderLinksMethods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface LinkResolverContext
resolveLinkMethods inherited from interface NodeRendererContext
doNotRenderLinks, doNotRenderLinks, doRenderLinks, getHtmlWriter, isDoNotRenderLinks
-
Field Details
-
document
-
renderers
-
phasedRenderers
-
myLinkResolvers
-
renderingPhases
-
options
-
phase
-
htmlIdGenerator
HtmlIdGenerator htmlIdGenerator -
resolvedLinkMap
-
attributeProviders
-
-
Constructor Details
-
MainNodeRenderer
MainNodeRenderer(DataHolder options, HtmlWriter htmlWriter, Document document)
-
-
Method Details
-
dispose
public void dispose()- Specified by:
disposein interfaceDisposable
-
getCurrentNode
- Specified by:
getCurrentNodein interfaceLinkResolverContext- Returns:
- the current node being rendered
-
resolveLink
@NotNull public @NotNull ResolvedLink resolveLink(@NotNull @NotNull LinkType linkType, @NotNull @NotNull CharSequence url, Attributes attributes, Boolean urlEncode) Description copied from interface:LinkResolverContextResolve link for rendering. Link Resolvers are going to be called until one returns ResolvedLink with getStatus() != LinkStatus.UnknownA resolver can replace the url but not change the status letting downstream resolvers handle the rest. This is useful when a resolver does partial processing like macro expansion but does not know how to handle the rest.
Core processing will simply pass the link as is. It is up to extension LinkResolvers and AttributeProviders to make sense of the link and applicable attributes based on status.
- Specified by:
resolveLinkin interfaceLinkResolverContext- Parameters:
linkType- type of link being rendered. Core defined links are Link, Image. Extensions can define their ownurl- link url textattributes- link attributesurlEncode- whether the link should be url encoded, if null then the value ofHtmlRenderer.PERCENT_ENCODE_URLSwill be used to determine whether the resolved URL is to be encoded.- Returns:
- resolved link url for this link and its resolved status
-
getNodeId
Description copied from interface:NodeRendererContextGet the id attribute for the given node.- Specified by:
getNodeIdin interfaceNodeRendererContext- Parameters:
node- node for which to get an id, depends on theHtmlIdGeneratorassigned for the context. Default generator only creates ids forHeadingnodes or custom nodes that implementAnchorRefTargetinterface.- Returns:
- id string or null
-
getOptions
Description copied from interface:LinkResolverContextGet the current rendering contextDataHolder. These are the options passed or set on theHtmlRenderer.builder()or passed toHtmlRenderer.builder(DataHolder). To get the document options you should useLinkResolverContext.getDocument()as the data holder.- Specified by:
getOptionsin interfaceLinkResolverBasicContext- Specified by:
getOptionsin interfaceLinkResolverContext- Returns:
- the current renderer options
DataHolder
-
getHtmlOptions
- Specified by:
getHtmlOptionsin interfaceNodeRendererContext- Returns:
- the
HtmlRendererOptionsfor the context.
-
getDocument
- Specified by:
getDocumentin interfaceLinkResolverBasicContext- Specified by:
getDocumentin interfaceLinkResolverContext- Returns:
- the
Documentnode of the current context
-
getRenderingPhase
- Specified by:
getRenderingPhasein interfaceNodeRendererContext- Returns:
- current rendering phase
-
encodeUrl
- Specified by:
encodeUrlin interfaceLinkResolverContext- Parameters:
url- to be encoded- Returns:
- an encoded URL (depending on the configuration)
-
extendRenderingNodeAttributes
@NotNull public @NotNull MutableAttributes extendRenderingNodeAttributes(@NotNull @NotNull AttributablePart part, Attributes attributes) Description copied from interface:NodeRendererContextExtend the attributes by extensions for the node being currently rendered.- Specified by:
extendRenderingNodeAttributesin interfaceNodeRendererContext- Parameters:
part- the tag of the node being rendered, some nodes render multiple tags with attributesattributes- the attributes that were calculated by the renderer or null, these may be modified. To preserve originals pass a copy.- Returns:
- the extended attributes with added/updated/removed entries
-
extendRenderingNodeAttributes
@NotNull public @NotNull MutableAttributes extendRenderingNodeAttributes(@NotNull @NotNull Node node, @NotNull @NotNull AttributablePart part, Attributes attributes) Description copied from interface:NodeRendererContextExtend the attributes by extensions for the node being currently rendered.- Specified by:
extendRenderingNodeAttributesin interfaceNodeRendererContext- Parameters:
node- node for which to get attributespart- the tag of the node being rendered, some nodes render multiple tags with attributesattributes- the attributes that were calculated by the renderer or null, these may be modified. To preserve originals pass a copy.- Returns:
- the extended attributes with added/updated/removed entries
-
render
Description copied from interface:LinkResolverContextRender the specified node and its children using the configured renderers. This should be used to render child nodes; be careful not to pass the node that is being rendered, that would result in an endless loop.- Specified by:
renderin interfaceLinkResolverContext- Parameters:
node- the node to render
-
delegateRender
public void delegateRender()Description copied from interface:NodeRendererContextpass node rendering to previously registered handler- Specified by:
delegateRenderin interfaceNodeRendererContext
-
renderByPreviousHandler
-
getSubContext
Description copied from interface:NodeRendererContextCreates a child rendering context that can be used to collect rendered html text. The child context inherits everything but the HtmlRenderer, renderedNode, renderingHandler and doNotRenderLinksNesting from the parent.- Specified by:
getSubContextin interfaceNodeRendererContext- Parameters:
inheritIndent- whether the html writer of the sub-context should inherit the current context's indentation level or start with 0 indentation- Returns:
- a new rendering context with a given appendable for its output
-
getDelegatedSubContext
Description copied from interface:NodeRendererContextCreates a child rendering context that can be used to collect rendered html text of the previously registered node renderer. The child context inherits everything but the HtmlRenderer and doNotRenderLinksNesting from the parent.- Specified by:
getDelegatedSubContextin interfaceNodeRendererContext- Parameters:
inheritIndent- whether the html writer of the sub-context should inherit the current context's indentation level or start with 0 indentation- Returns:
- a new rendering context with a given appendable for its output
-
renderNode
-
renderChildren
Description copied from interface:LinkResolverContextRender the children of the node, used by custom renderers- Specified by:
renderChildrenin interfaceLinkResolverContext- Parameters:
parent- node the children of which are to be rendered
-
renderChildrenNode
-