# The Dom\CharacterData class

(PHP 8 >= 8.4.0)

## Introduction

Represents nodes with character data. No nodes directly correspond to this class, but other nodes do inherit from it.

This is the modern, spec-compliant equivalent of DOMCharacterData.

## Class synopsis

class Dom\CharacterData extends Dom\Node implements Dom\ChildNode {
/* Inherited constants */
public const int Dom\Node::DOCUMENT_POSITION_DISCONNECTED = 0x1;
public const int Dom\Node::DOCUMENT_POSITION_PRECEDING = 0x2;
public const int Dom\Node::DOCUMENT_POSITION_FOLLOWING = 0x4;
public const int Dom\Node::DOCUMENT_POSITION_CONTAINS = 0x8;
public const int Dom\Node::DOCUMENT_POSITION_CONTAINED_BY = 0x10;
public const int Dom\Node::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
/* Properties */
public readonly ?Dom\Element $previousElementSibling;
public readonly ?Dom\Element $nextElementSibling;
public string $data;
public readonly int $length;
/* Inherited properties */
public readonly int $nodeType;
public readonly string $nodeName;
public readonly string $baseURI;
public readonly bool $isConnected;
public readonly ?Dom\Document $ownerDocument;
public readonly ?Dom\Node $parentNode;
public readonly ?Dom\Element $parentElement;
public readonly Dom\NodeList $childNodes;
public readonly ?Dom\Node $firstChild;
public readonly ?Dom\Node $lastChild;
public readonly ?Dom\Node $previousSibling;
public readonly ?Dom\Node $nextSibling;
public ?string $nodeValue;
public ?string $textContent;
/* Methods */
public after(Dom\Node|string `...$nodes`): void
public appendData(string `$data`): void
public before(Dom\Node|string `...$nodes`): void
public deleteData(int `$offset`, int `$count`): void
public insertData(int `$offset`, string `$data`): void
public remove(): void
public replaceData(int `$offset`, int `$count`, string `$data`): void
public replaceWith(Dom\Node|string `...$nodes`): void
public substringData(int `$offset`, int `$count`): string
/* Inherited methods */
/* Not documented yet */
}

## Properties

previousElementSibling

  The previous sibling element or `null`.

nextElementSibling

  The next sibling element or `null`.

data

  The contents of the node.

length

  The length of the contents.

## See Also

- » WHATWG specification of CharacterData

## Table of Contents

- Dom\CharacterData::after — Adds nodes after the character data
- Dom\CharacterData::appendData — Append the string to the end of the character data of the node
- Dom\CharacterData::before — Adds nodes before the character data
- Dom\CharacterData::deleteData — Remove a range of characters from the character data
- Dom\CharacterData::insertData — Insert a string at the specified UTF-8 codepoint offset
- Dom\CharacterData::remove — Removes the character data node
- Dom\CharacterData::replaceData — Replace a substring within the character data
- Dom\CharacterData::replaceWith — Replaces the character data with new nodes
- Dom\CharacterData::substringData — Extracts a range of data from the character data

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open