foo` . The dsr * property of the data-parsoid attribute of this i-tag tells us the following. This HTML node * maps to input wikitext substring 7..14. The opening tag was 2 characters wide in wikitext * and the closing tag was also 2 characters wide in wikitext. * @property DomSourceRange|null $dsr * * Denotes special syntax. Possible values: * - 'html' for html tags. Ex: `
foo
` * - 'row' for dt/dd that show on the same line. Ex: `;a:b` (but not `;a\n:b`) * - 'piped' for piped wikilinks with explicit content Ex: `[[Foo|bar]]` (but not `[[Foo]]`) * - 'magiclink', 'url' - legacy, not used anymore * @property string|null $stx * * Template parameter infos produced by TemplateHandler. After unserialization, * the objects are not fully populated. * @property ParamInfo[][]|null $pi * * Expanded template HTML (native preprocessor only). * @property string|null $html * * On mw:Entity spans this is set to the decoded entity value. * @property string|null $srcContent * * An array of associative arrays describing image rendering options, attached * to the image container (span or figure). * - ck: Canonical key for the image option. * - ak: Aliased key. * @property array|null $optList * * Rendered attributes (shadow info). The key is the attribute name. The value * is documented as "mixed" but seems to be coerced to string in * Sanitizer::sanitizeTagAttrs(). * @property array|null $a Rendered attributes * * Source attributes (shadow info). The key is the attribute name. The value * is documented as "mixed" but may possibly be a nullable string. * @property array|null $sa Source attributes * * FIXME never written * @property bool|null $strippedNL * * The number of extra dashes in the source of an hr * @property int|null $extra_dashes * * The complete text of a double-underscore behavior switch * @property string|null $magicSrc * * True if the input heading element had an id attribute, preventing automatic * assignment of a new id attribute. * @property bool|null $reusedId * * FIXME: Get rid of this property and the code that reads it after content * version 2.2.0 has expired from caches. * @property mixed $liHackSrc * * The link token associated with a redirect * @property Token|null $linkTk * * On a meta mw:EmptyLine, the associated comment and whitespace tokens. Used * in this sense by both the tokenizer and TokenStreamPatcher. * @property array $tokens * * This is set to "extlink" on auto URL (external hotlink) image links. * @property string|null $type * * On a meta mw:Placeholder/StrippedTag, this is the name of the stripped tag. * @property string|null $name * * This is set on image containers in which a template expands to multiple * image parameters. It is converted to a typeof attribute later in the same * function, so it's unclear why it needs to persist in data-parsoid. * @property bool|null $uneditable * * == WrapTemplates == * * The wikitext source which was not included in a template wrapper. * @property string|null $unwrappedWT * * The token or DOM node name, optionally suffixed with the syntax name from * $this->stx, of the first node within the encapsulated content. * @property string|null $firstWikitextNode * * == Extensions == * * Offsets of opening and closing tags for extension tags, in the form * [ opening tag start , closing tag end, opening tag width, closing tag width ] * Temporarily present in data-parsoid, but not in final DOM output. * @property DomSourceRange|null $extTagOffsets * * This is true on the extension output wrapper if the extension input wikitext * was an empty string. Consumed by . * @property bool $empty * * The reference group. This is attached to the
    or its wrapper
    , * redundantly with the data-mw-group attribute on the
      . It is produced by * the extension's sourceToDom() and consumed by wtPostprocess(). * @property string $group * * == Annotations == * This is used on annotation meta tags to indicate that the corresponding * tag has been moved compared to it's initial location defined by wikitext. * An annotation tag can be moved either as the result of fostering or as * the result of annotation range extension to enclose a contiguous DOM * forest. * @property bool|null $wasMoved * * == HTML tags == * * Are void tags self-closed? (Ex: `
      ` vs `
      `) * @property bool|null $selfClose * * Void tags that are not self-closed (Ex: `
      `) * @property bool|null $noClose * * Whether this start HTML tag has no corresponding wikitext and was auto-inserted by a token * handler to generate well-formed html. Usually happens when a token handler fixes up misnesting. * @property bool|null $autoInsertedStartToken * * Whether this end HTML tag has no corresponding wikitext and was auto-inserted by a token * handler to generate well-formed html. Usually happens when a token handler fixes up misnesting. * @property bool|null $autoInsertedEndToken * * Whether this start HTML tag has no corresponding wikitext and was auto-inserted to generate * well-formed html. Usually happens when treebuilder fixes up badly nested HTML. * @property bool|null $autoInsertedStart * * Whether this end HTML tag has no corresponding wikitext and was auto-inserted to generate * well-formed html. Ex: ``, ``, ``, `
    1. `, etc. that have no explicit closing * markup. Or, html tags that aren't closed. * @property bool|null $autoInsertedEnd * * Source tag name for HTML tags. Records case variations (`
      ` vs `
      ` vs `
      `). * @property string|null $srcTagName * * UnpackDomFragments sets this on misnested elements * @property bool|null $misnested * * This is set by MarkFosteredContent to indicate fostered content and content * wrappers. * @property bool|null $fostered * * == Links == * * Link trail source (Ex: the "l" in `[[Foo]]l`) * Porting note: this can be '0', handle emptiness checks with care * @property string|null $tail * * Link prefix source * Porting note: this can be '0', handle emptiness checks with care * @property string|null $prefix * * True if the link was a pipetrick (`[[Foo|]]`). * @note This will likely be removed soon since this should not show up in saved wikitext since * this is a pre-save transformation trick. * @property bool|null $pipeTrick * * Offsets of external link content. * Temporarily present in data-parsoid, but not in final DOM output. * @property SourceRange|null $extLinkContentOffsets * * Did the link use interwiki syntax? * Probably redundant with the rel=mw:WikiLink/Interwiki * @property bool|null $isIW * * == Tables == * * Source for start-text separators in table wikitext. * @property string|null $startTagSrc * * Source for end-text separators in table wikitext. * @property string|null $endTagSrc * * Source for attribute-text separators in table wikitext. * @property string|null $attrSepSrc * * 'row' for td/th cells that show up on the same line, null otherwise * @property string|null $stx_v * * == Language variant token properties == * * @property array|null $flags Flags with their human-readable names * @property array|null $variants The variant names * @property array|null $original Original flags * @property array|null $flagSp Spaces around flags, uncompressed * * An array of associative arrays describing the parts of the variant rule. * - text: (string) The text * - semi: (bool) A semicolon marker * - sp: (array|string) An array of strings containing spaces * - oneway: (bool) A one-way rule definition * - twoway: (bool) A two-way rule definition * - from: (array) An associative array: * - tokens: (array) A token array * - srcOffsets: SourceRange * - to: (array) An associative array same as "from" * - lang: (string) * @property array|null $texts * * == Language variant data-parsoid properties == * * @property array|null $flSp Spaces around flags, compressed with compressSpArray(). * @property array|null $tSp Spaces around texts, compressed with compressSpArray(). * @property array|null $fl Original flags, copied from $this->original on the token. */ class DataParsoid { /** * Holds a number of transient properties in the wt->html pipeline to pass information between * stages. Dropped before serialization. * @var TempData|null */ public $tmp; /** * Deeply clone this object * * @return DataParsoid */ public function clone(): self { $dp = clone $this; // Properties that need deep cloning if ( isset( $dp->tmp ) ) { $dp->tmp = Utils::clone( $dp->tmp ); } if ( isset( $dp->linkTk ) ) { $dp->linkTk = Utils::clone( $dp->linkTk ); } if ( isset( $dp->tokens ) ) { $dp->tokens = Utils::clone( $dp->tokens ); } // Properties that need shallow cloning if ( isset( $dp->tsr ) ) { $dp->tsr = clone $dp->tsr; } if ( isset( $dp->dsr ) ) { $dp->dsr = clone $dp->dsr; } if ( isset( $dp->extTagOffsets ) ) { $dp->extTagOffsets = clone $dp->extTagOffsets; } if ( isset( $dp->extLinkContentOffsets ) ) { $dp->extLinkContentOffsets = clone $dp->extLinkContentOffsets; } // The remaining properties were sufficiently handled by the clone operator return $dp; } public function isModified() { // NOTE: strict equality will not work in this comparison // @phan-suppress-next-line PhanPluginComparisonObjectEqualityNotStrict return $this != new self; } /** * Get a lazy-initialized object to which temporary properties can be written. * @return TempData */ public function getTemp(): TempData { // tmp can be unset despite being declared if ( !isset( $this->tmp ) ) { $this->tmp = new TempData; } return $this->tmp; } /** * Check whether a bit is set in $this->tmp->bits * * @param int $flag * @return bool */ public function getTempFlag( $flag ): bool { return isset( $this->tmp ) && ( $this->tmp->bits & $flag ); } /** * Set a bit in $this->tmp->bits * * @param int $flag * @param bool $value */ public function setTempFlag( $flag, $value = true ): void { if ( $value ) { if ( !isset( $this->tmp ) ) { $tmp = new TempData; $tmp->bits = $flag; $this->tmp = $tmp; } else { $this->tmp->bits |= $flag; } } elseif ( isset( $this->tmp ) ) { $this->tmp->bits &= ~$flag; } } }