Inheritance diagram for Wikimedia\RemexHtml\Serializer\SerializerWithTracer:

Public Member Functions
	__construct (Formatter $formatter, $errorCallback=null, $traceCallback=null, $verbosity=0)

	startDocument ( $fragmentNamespace, $fragmentName)
	Called when parsing starts.

	endDocument ( $pos)
	Called when parsing stops.

	characters ( $preposition, $refElement, $text, $start, $length, $sourceStart, $sourceLength)
	Insert characters.

	insertElement ( $preposition, $refElement, Element $element, $void, $sourceStart, $sourceLength)
	Insert an element.

	endTag (Element $element, $sourceStart, $sourceLength)
	A hint that an element was closed and was removed from the stack of open elements.

	doctype ( $name, $public, $system, $quirks, $sourceStart, $sourceLength)
	A valid DOCTYPE token was found.

	comment ( $preposition, $refElement, $text, $sourceStart, $sourceLength)
	Insert a comment.

	error ( $text, $pos)
	A parse error.

	mergeAttributes (Element $element, Attributes $attrs, $sourceStart)
	Add attributes to an existing element.

	removeNode (Element $element, $sourceStart)
	Remove a node from the tree, and all its children.

	reparentChildren (Element $element, Element $newParent, $sourceStart)
	Take all children of a given parent $element, and insert them as children of $newParent, removing them from their original parent in the process.

Public Member Functions inherited from Wikimedia\RemexHtml\Serializer\Serializer
	__construct (Formatter $formatter, $errorCallback=null)
	Constructor.

string	getResult ()
	Get the final string.

SerializerNode	getRootNode ()
	Get the root SerializerNode.

SerializerNode	getParentNode (SerializerNode $node)
	Get the parent SerializerNode of a given SerializerNode.

SerializerNode string null	getLastChild (SerializerNode $node)
	Get the last child of a given SerializerNode.

string	dump ()
	Get a text representation of the current state of the serializer, for debugging.

Additional Inherited Members
Protected Member Functions inherited from Wikimedia\RemexHtml\Serializer\Serializer
	interpretPlacement ( $preposition, $refElement)

Protected Attributes inherited from Wikimedia\RemexHtml\Serializer\Serializer
SerializerNode[]	$nodes = array( )
	All active SerializerNode objects in an array, so that they can be referred to by integer indexes.

Member Function Documentation

◆ characters()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::characters	(	$preposition,
		$ref,
		$text,
		$start,
		$length,
		$sourceStart,
		$sourceLength )

Insert characters.

Parameters

int	$preposition	The placement of the new node with respect to $ref. May be TreeBuilder:: BEFORE: insert as a sibling before the reference element UNDER: append as the last child of the reference element ROOT: append as the last child of the document node
Element \| null	$ref	Insert before/below this element, or null if $preposition is ROOT.
string	$text	The text to insert is a substring of this string, with the start and length of the substring given by $start and $length. We do it this way to avoid unnecessary copying.
int	$start	The start of the substring
int	$length	The length of the substring
int	$sourceStart	The input position. This is not necessarily accurate, particularly when the tokenizer is run without ignoreEntities, or in CDATA sections.
int	$sourceLength	The length of the input which is consumed. The same caveats apply as for $sourceStart.

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ comment()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::comment	(	$preposition,
		$ref,
		$text,
		$sourceStart,
		$sourceLength )

Insert a comment.

Parameters

int	$preposition	The placement of the new node with respect to $ref. May be TreeBuilder:: BEFORE: insert as a sibling before the reference element UNDER: append as the last child of the reference element ROOT: append as the last child of the document node
Element \| null	$ref	Insert before/below this element, or null if $preposition is ROOT.
string	$text	The text of the comment
int	$sourceStart	The input position
int	$sourceLength	The length of the input which is consumed

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ doctype()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::doctype	(	$name,
		$public,
		$system,
		$quirks,
		$sourceStart,
		$sourceLength )

A valid DOCTYPE token was found.

Parameters

string	$name	The doctype name, usually "html"
string	$public	The PUBLIC identifier
string	$system	The SYSTEM identifier
int	$quirks	The quirks mode implied from the doctype. One of: TreeBuilder::NO_QUIRKS : no quirks TreeBuilder::LIMITED_QUIRKS : limited quirks TreeBuilder::QUIRKS : full quirks
int	$sourceStart	The input position
int	$sourceLength	The length of the input which is consumed

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ endDocument()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::endDocument ( $pos )

Called when parsing stops.

Parameters

int $pos The input string length, i.e. the past-the-end position.

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ endTag()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::endTag	(	Element	$element,
			$sourceStart,
			$sourceLength )

A hint that an element was closed and was removed from the stack of open elements.

It probably won't be mutated again.

Parameters

Element	$element	The element being ended
int	$sourceStart	The input position
int	$sourceLength	The length of the input which is consumed

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ error()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::error	(		$text,
			$pos )

A parse error.

Parameters

string	$text	An error message explaining in English what the author did wrong, and what the parser intends to do about the situation.
int	$pos	The input position at which the error occurred

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ insertElement()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::insertElement	(		$preposition,
			$ref,
		Element	$element,
			$void,
			$sourceStart,
			$sourceLength )

Insert an element.

The element name and attributes are given in the supplied Element object. Handlers for this event typically attach an identifier to the userData property of the Element object, to identify the element when it is used again in subsequent tree mutations.

Parameters

int	$preposition	The placement of the new node with respect to $ref. May be TreeBuilder:: BEFORE: insert as a sibling before the reference element UNDER: append as the last child of the reference element ROOT: append as the last child of the document node
Element \| null	$ref	Insert before/below this element, or null if $preposition is ROOT.
Element	$element	An object containing information about the new element. The same object will be used for $parent and $refNode in other calls as appropriate. The handler can set $element->userData to attach a suitable DOM object to identify the mutation target in subsequent calls.
bool	$void	True if this is a void element which cannot have any children appended to it. This is usually true if the element is closed by the same token that opened it. No endTag() event will be sent for such an element. This is only true if self-closing tags are acknowledged for this tag name, so it is a hint to the serializer that a self-closing tag is acceptable.
int	$sourceStart	The input position
int	$sourceLength	The length of the input which is consumed

Implements Wikimedia\RemexHtml\TreeBuilder\TreeHandler.

◆ mergeAttributes()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::mergeAttributes	(	Element	$element,
		Attributes	$attrs,
			$sourceStart )

Add attributes to an existing element.

This is used to update the attributes of the <html> or <body> elements. The event receiver should add only those attributes which the original element does not already have. It should not overwrite existing attributes.

Parameters

Element	$element	The element to update
Attributes	$attrs	The new attributes to add
int	$sourceStart	The input position

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ removeNode()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::removeNode	(	Element	$element,
			$sourceStart )

Remove a node from the tree, and all its children.

This is only done when a <frameset> element is found, which triggers removal of the partially-constructed body element.

Parameters

Element	$element	The element to remove
int	$sourceStart	The location in the source at which this action was triggered.

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ reparentChildren()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::reparentChildren	(	Element	$element,
		Element	$newParent,
			$sourceStart )

Take all children of a given parent $element, and insert them as children of $newParent, removing them from their original parent in the process.

Insert $newParent as now the only child of $element.

Parameters

Element	$element	The old parent element
Element	$newParent	The new parent element
int	$sourceStart	The location in the source at which this action was triggered.

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

◆ startDocument()

Wikimedia\RemexHtml\Serializer\SerializerWithTracer::startDocument	(		$fragmentNamespace,
			$fragmentName )

Called when parsing starts.

Parameters

string \| null	$fragmentNamespace	The fragment namespace, or null to run in document mode.
string \| null	$fragmentName	The fragment tag name, or null to run in document mode.

Reimplemented from Wikimedia\RemexHtml\Serializer\Serializer.

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

src/Serializer/SerializerWithTracer.php

Public Member Functions

Additional Inherited Members

Member Function Documentation

◆ characters()

◆ comment()

◆ doctype()

◆ endDocument()

◆ endTag()

◆ error()

◆ insertElement()

◆ mergeAttributes()

◆ removeNode()

◆ reparentChildren()

◆ startDocument()