Parsoid
A bidirectional parser between wikitext and HTML5
Loading...
Searching...
No Matches
Wikimedia\Parsoid\Ext\Indicator\Indicator Class Reference

Implements the php parser's indicator hook natively. More...

+ Inheritance diagram for Wikimedia\Parsoid\Ext\Indicator\Indicator:
+ Collaboration diagram for Wikimedia\Parsoid\Ext\Indicator\Indicator:

Public Member Functions

 getConfig ()
 Return information about this extension module.The structure of the return value is enforced by moduleconfig.schema.json, in this directory.
See also
https://www.mediawiki.org/wiki/Parsoid/Internals/Module_Configuration_Schema
Returns
array{name:string}

 
 processAttributeEmbeddedDom (ParsoidExtensionAPI $extApi, Element $elt, callable $proc)
 Extensions might embed HTML in attributes in their own custom representation (whether in data-mw or elsewhere).Core Parsoid will need a way to traverse such content. This method is a way for extension tag handlers to provide this functionality. Parsoid will only call this method if the tag's config sets the options['wt2html']['embedsDomInAttributes'] property to true.
Parameters
ParsoidExtensionAPI$extApi
Element$eltThe node whose data attributes need to be examined
callable(DocumentFragment):bool$proc The processor that will process the embedded HTML. This processor will be provided a DocumentFragment and is expected to return true if that fragment was modified.
Deprecated
since 0.24; register extension-specific rich attribute instead

 
 sourceToDom (ParsoidExtensionAPI $extApi, string $content, array $args)
 Convert an extension tag's content to "prepared and loaded" DOM.
Parameters
ParsoidExtensionAPI$extApi
string$contentExtension tag content
array$argsExtension tag arguments The extension tag arguments should be treated as opaque objects and any necessary inspection should be handled through the API.
Returns
DocumentFragment|false|null DocumentFragment if returning some parsed content false to fallback to the default handler for the content null to drop the instance completely
Exceptions
ExtensionError

 
- Public Member Functions inherited from Wikimedia\Parsoid\Ext\ExtensionTagHandler
 lintHandler (ParsoidExtensionAPI $extApi, Element $rootNode, callable $defaultHandler)
 Lint handler for this extension.
 
 domToWikitext (ParsoidExtensionAPI $extApi, Element $node, bool $wrapperUnmodified)
 Serialize a DOM node created by this extension to wikitext.
 
 diffHandler (ParsoidExtensionAPI $extApi, callable $domDiff, Element $origNode, Element $editedNode)
 XXX: Experimental.
 

Detailed Description

Implements the php parser's indicator hook natively.

Member Function Documentation

◆ getConfig()

Wikimedia\Parsoid\Ext\Indicator\Indicator::getConfig ( )

Return information about this extension module.The structure of the return value is enforced by moduleconfig.schema.json, in this directory.

See also
https://www.mediawiki.org/wiki/Parsoid/Internals/Module_Configuration_Schema
Returns
array{name:string}

Implements Wikimedia\Parsoid\Ext\ExtensionModule.

◆ processAttributeEmbeddedDom()

Wikimedia\Parsoid\Ext\Indicator\Indicator::processAttributeEmbeddedDom ( ParsoidExtensionAPI $extApi,
Element $elt,
callable $proc )

Extensions might embed HTML in attributes in their own custom representation (whether in data-mw or elsewhere).Core Parsoid will need a way to traverse such content. This method is a way for extension tag handlers to provide this functionality. Parsoid will only call this method if the tag's config sets the options['wt2html']['embedsDomInAttributes'] property to true.

Parameters
ParsoidExtensionAPI$extApi
Element$eltThe node whose data attributes need to be examined
callable(DocumentFragment):bool$proc The processor that will process the embedded HTML. This processor will be provided a DocumentFragment and is expected to return true if that fragment was modified.
Deprecated
since 0.24; register extension-specific rich attribute instead

Reimplemented from Wikimedia\Parsoid\Ext\ExtensionTagHandler.

◆ sourceToDom()

Wikimedia\Parsoid\Ext\Indicator\Indicator::sourceToDom ( ParsoidExtensionAPI $extApi,
string $content,
array $args )

Convert an extension tag's content to "prepared and loaded" DOM.

Parameters
ParsoidExtensionAPI$extApi
string$contentExtension tag content
array$argsExtension tag arguments The extension tag arguments should be treated as opaque objects and any necessary inspection should be handled through the API.
Returns
DocumentFragment|false|null DocumentFragment if returning some parsed content false to fallback to the default handler for the content null to drop the instance completely
Exceptions
ExtensionError

Reimplemented from Wikimedia\Parsoid\Ext\ExtensionTagHandler.


The documentation for this class was generated from the following file: