Wikimedia\Parsoid\Fragments\HtmlPFragment Class Reference

An atomic fragment represented as an HTML string with inline data attributes, not necessarily balanced. More...

Inheritance diagram for Wikimedia\Parsoid\Fragments\HtmlPFragment:

Collaboration diagram for Wikimedia\Parsoid\Fragments\HtmlPFragment:

Public Member Functions
	isEmpty ()
	Returns true if this fragment is empty.This enables optimizations if implemented, but returns false by default.
	asHtmlString (ParsoidExtensionAPI $extApi)
	Return the fragment as a string of HTML.This method is very similar to asDom() but also supports fragmentary and unbalanced HTML, and therefore composition may yield unexpected results. This is a common type in legacy MediaWiki code, but use in new code should be discouraged. Data attributes will be represented as inline attributes, which may be suboptimal. Note The default implementation of asHtmlString() calls asDom(). Subclassses must implement either asDom() or asHtmlString() to avoid infinite mutual recursion.
	toJsonArray ()
Public Member Functions inherited from Wikimedia\Parsoid\Fragments\PFragment
	isAtomic ()
	Returns true if this fragment contains no wikitext elements; that is, if ::asMarkedWikitext() given an empty strip state would return a single strip marker and add a single item to the strip state (representing $this).
	isValid ()
	As an optimization to avoid unnecessary copying, certain operations on fragments may be destructive or lead to aliasing.
	getSrcOffsets ()
	Return the region of the source document that corresponds to this fragment.
	asDom (ParsoidExtensionAPI $extApi, bool $release=false)
	Return the fragment as a (prepared and loaded) DOM DocumentFragment belonging to the Parsoid top-level document.
	asMarkedWikitext (StripState $stripState)
	This method returns a "wikitext string" in the legacy format.
	containsMarker ()
	Returns true if this fragment contains some non-wikitext content.
	split ()
	Split this fragment at its strip markers and return an array which alternates between string items and PFragment items.
	killMarkers ()
	Return a version of this fragment with all non-wikitext content removed.
	markerSkipCallback (callable $callback)
	Call a callback function on all regions of the given text that are wikitext content, replacing them with the return value of the callback.
	trim ()
	Trim leading and trailing wikitext whitespace from this fragment.
	expand (ParsoidExtensionAPI $extApi, ?bool &$error=null)
	Expand templates, extension tags, and parser functions in a fragment.
	toRawText (ParsoidExtensionAPI $extApi)
	Return the 'raw text' of this fragment.

Static Public Member Functions
static	newFromHtmlString (string $html, ?DomSourceRange $srcOffsets)
	Create a new HtmlPFragment from the given HTML string and optional source string.
static	castFromPFragment (ParsoidExtensionAPI $ext, PFragment $fragment)
	Return a new HtmlPFragment corresponding to the given PFragment.
static	concat (ParsoidExtensionAPI $ext, PFragment ... $fragments)
	Return a HtmlPFragment representing the concatenation of the given fragments, as (unbalanced) HTML strings.
static	newFromJsonArray (array $json)
	Exceptions JsonException
static	jsonClassHintFor (string $keyName)
Static Public Member Functions inherited from Wikimedia\Parsoid\Fragments\PFragment
static	fromSplitWt (array $pieces, ?DomSourceRange $srcOffset=null)
	Helper function to create a new fragment from a mixed array of strings and fragments.
static	registerFragmentClass (string $className)
	Register a fragment type with the JSON deserialization code.
static	hint ()

Public Attributes
const	TYPE_HINT = 'html'

Additional Inherited Members
Protected Member Functions inherited from Wikimedia\Parsoid\Fragments\PFragment
	__construct (?DomSourceRange $srcOffsets)
Static Protected Member Functions inherited from Wikimedia\Parsoid\Fragments\PFragment
static	joinSourceRange (?DomSourceRange $first, ?DomSourceRange $second)
	Helper function to append two source ranges.
Protected Attributes inherited from Wikimedia\Parsoid\Fragments\PFragment
DomSourceRange	$srcOffsets
	The original wikitext source range for this fragment, or null for synthetic content that corresponds to no part of the original authored text.
Static Protected Attributes inherited from Wikimedia\Parsoid\Fragments\PFragment
static array	$FRAGMENT_TYPES

Detailed Description

An atomic fragment represented as an HTML string with inline data attributes, not necessarily balanced.

Member Function Documentation

asHtmlString()

Wikimedia\Parsoid\Fragments\HtmlPFragment::asHtmlString

(

ParsoidExtensionAPI

$extApi

)

Return the fragment as a string of HTML.This method is very similar to asDom() but also supports fragmentary and unbalanced HTML, and therefore composition may yield unexpected results. This is a common type in legacy MediaWiki code, but use in new code should be discouraged. Data attributes will be represented as inline attributes, which may be suboptimal.

Note

The default implementation of asHtmlString() calls asDom(). Subclassses must implement either asDom() or asHtmlString() to avoid infinite mutual recursion.

Reimplemented from Wikimedia\Parsoid\Fragments\PFragment.

castFromPFragment()

static Wikimedia\Parsoid\Fragments\HtmlPFragment::castFromPFragment ( ParsoidExtensionAPI $ext, PFragment $fragment )

static

Return a new HtmlPFragment corresponding to the given PFragment.

If the fragment is not already an HtmlPFragment, this will convert it using PFragment::asHtmlString().

isEmpty()

Wikimedia\Parsoid\Fragments\HtmlPFragment::isEmpty

(

)

Returns true if this fragment is empty.This enables optimizations if implemented, but returns false by default.

Reimplemented from Wikimedia\Parsoid\Fragments\PFragment.

jsonClassHintFor()

static Wikimedia\Parsoid\Fragments\HtmlPFragment::jsonClassHintFor ( string $keyName )

static

Reimplemented from Wikimedia\Parsoid\Fragments\PFragment.

newFromJsonArray()

static Wikimedia\Parsoid\Fragments\HtmlPFragment::newFromJsonArray ( array $json )

static

Exceptions

JsonException

Reimplemented from Wikimedia\Parsoid\Fragments\PFragment.

toJsonArray()

Wikimedia\Parsoid\Fragments\HtmlPFragment::toJsonArray

(

)

Reimplemented from Wikimedia\Parsoid\Fragments\PFragment.

---

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

• src/Fragments/HtmlPFragment.php