Parsoid
A bidirectional parser between wikitext and HTML5
Loading...
Searching...
No Matches
Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper Class Reference

Insert paragraph tags where needed – smartly and carefully – there is much fun to be had mimicking "wikitext visual newlines" behavior as implemented by the PHP parser. More...

+ Inheritance diagram for Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper:
+ Collaboration diagram for Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper:

Public Member Functions

 __construct (TokenTransformManager $manager, array $options)
 Constructor for paragraph wrapper.
 
 onNewline (NlTk $token)
 This handler is called for newline tokens only.
Parameters
NlTk$tokenNewline token to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

 
 onEnd (EOFTk $token)
 This handler is called for EOF tokens only.
Parameters
EOFTk$tokenEOF token to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

 
 processOneNlTk (array &$out, &$offset)
 Append tokens from the newline/whitespace buffer to the output array until a newline is encountered.
 
 onAny ( $token)
 This handler is called for all tokens in the token stream except if (a) The more specific handlers above modified the token (b) the more specific handlers (onTag, onEnd, onNewline) have set the skip flag in their return values.(c) this handlers 'active' flag is set to false (can be set by any of the handlers).
Parameters
Token | string$tokenToken to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

 
- Public Member Functions inherited from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler
 setPipelineId (int $id)
 
 resetState (array $options)
 Resets any internal state for this token handler.
 
 isDisabled ()
 Is this transformer disabled?
 
 onTag (Token $token)
 This handler is called for tokens that are not EOFTk or NLTk tokens.
 
 process ( $tokens)
 Push an input array of tokens through the transformer and return the transformed tokens.
 

Additional Inherited Members

- Protected Attributes inherited from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler
 $env
 
 $manager
 
 $pipelineId
 
 $options
 
bool $disabled = false
 This is set if the token handler is disabled for the entire pipeline.
 
bool $onAnyEnabled = true
 This is set/reset by the token handlers at various points in the token stream based on what is encountered.
 
 $atTopLevel = false
 

Detailed Description

Insert paragraph tags where needed – smartly and carefully – there is much fun to be had mimicking "wikitext visual newlines" behavior as implemented by the PHP parser.

Constructor & Destructor Documentation

◆ __construct()

Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper::__construct ( TokenTransformManager $manager,
array $options )

Constructor for paragraph wrapper.

Parameters
TokenTransformManager$managermanager enviroment
array$optionsvarious configuration options

Reimplemented from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler.

Member Function Documentation

◆ onAny()

Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper::onAny ( $token)

This handler is called for all tokens in the token stream except if (a) The more specific handlers above modified the token (b) the more specific handlers (onTag, onEnd, onNewline) have set the skip flag in their return values.(c) this handlers 'active' flag is set to false (can be set by any of the handlers).

Parameters
Token | string$tokenToken to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

Reimplemented from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler.

◆ onEnd()

Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper::onEnd ( EOFTk $token)

This handler is called for EOF tokens only.

Parameters
EOFTk$tokenEOF token to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

Reimplemented from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler.

◆ onNewline()

Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper::onNewline ( NlTk $token)

This handler is called for newline tokens only.

Parameters
NlTk$tokenNewline token to be processed
Returns
TokenHandlerResult|null A TokenHandlerResult, or null to efficiently indicate that the input token is unchanged.

Reimplemented from Wikimedia\Parsoid\Wt2Html\TT\TokenHandler.

◆ processOneNlTk()

Wikimedia\Parsoid\Wt2Html\TT\ParagraphWrapper::processOneNlTk ( array & $out,
& $offset )

Append tokens from the newline/whitespace buffer to the output array until a newline is encountered.

Increment the offset reference. Return the newline token.

Parameters
array&$outarray to append to
int&$offsetThe offset reference to update
Returns
Token

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