MediaWiki master
MediaWiki\OutputTransform\ContentDOMTransformStage Class Reference

OutputTransformStages that modify the content as a HTML DOM tree. More...

Inherits MediaWiki\OutputTransform\OutputTransformStage.

Inherited by MediaWiki\OutputTransform\Stages\HandleParsoidSectionLinks, and MediaWiki\OutputTransform\Stages\ParsoidLocalization.

Collaboration diagram for MediaWiki\OutputTransform\ContentDOMTransformStage:

Public Member Functions

 transform (ParserOutput $po, ?ParserOptions $popts, array &$options)
 Transforms the input ParserOutput into the returned ParserOutput.The returned ParserOutput can explicitly be a modified version of the input ParserOutput; if modifications to that object are unexpected, a copy should be made before passing it to this method. TODO Some transformations require the possibility of modifying options (this is the case of ExecutePostCacheTransformHooks in particular). We do NOT want to keep this mechanism for later versions of this interface - the currently foreseen goal is to not pass $options at all. Modifying $options during this pass is considered deprecated.

Stability: unstable

 
 transformDOM (Document $dom, ParserOutput $po, ?ParserOptions $popts, array &$options)
 Applies the transformation to a DOM document.
 
- Public Member Functions inherited from MediaWiki\OutputTransform\OutputTransformStage
 __construct (ServiceOptions $options, LoggerInterface $logger)
 
 shouldRun (ParserOutput $po, ?ParserOptions $popts, array $options=[])
 Decides whether or not the stage should be run.
 

Additional Inherited Members

- Public Attributes inherited from MediaWiki\OutputTransform\OutputTransformStage
const CONSTRUCTOR_OPTIONS = []
 
- Protected Attributes inherited from MediaWiki\OutputTransform\OutputTransformStage
LoggerInterface $logger
 
ServiceOptions $options
 

Detailed Description

OutputTransformStages that modify the content as a HTML DOM tree.

Subclasses are expected to implement ::transformDOM() to mutate the DOM-structured content as a Document in-place.

Access: internal

Definition at line 28 of file ContentDOMTransformStage.php.

Member Function Documentation

◆ transform()

MediaWiki\OutputTransform\ContentDOMTransformStage::transform ( ParserOutput $po,
?ParserOptions $popts,
array & $options )

Transforms the input ParserOutput into the returned ParserOutput.The returned ParserOutput can explicitly be a modified version of the input ParserOutput; if modifications to that object are unexpected, a copy should be made before passing it to this method. TODO Some transformations require the possibility of modifying options (this is the case of ExecutePostCacheTransformHooks in particular). We do NOT want to keep this mechanism for later versions of this interface - the currently foreseen goal is to not pass $options at all. Modifying $options during this pass is considered deprecated.

Stability: unstable

Reimplemented from MediaWiki\OutputTransform\OutputTransformStage.

Definition at line 33 of file ContentDOMTransformStage.php.

◆ transformDOM()

MediaWiki\OutputTransform\ContentDOMTransformStage::transformDOM ( Document $dom,
ParserOutput $po,
?ParserOptions $popts,
array & $options )
abstract

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