International PHP Conference Berlin 2025

DOMCharacterData::before

(PHP 8)

DOMCharacterData::beforeAjoute des nœuds avant les données de caractère

Description

public DOMCharacterData::before(DOMNode|string ...$nodes): void

Ajoute les nodes passés avant les données de caractère.

Liste de paramètres

nodes

Nœuds à ajouter avant le nœud. Les chaînes de caractères sont automatiquement convertie en des nœuds de texte.

Valeurs de retour

Aucune valeur n'est retournée.

Erreurs / Exceptions

DOM_HIERARCHY_REQUEST_ERR

Levée si le parent est d'un type qui n'autorise pas les enfants du type de l'un des nodes transmis, ou si le nœud à insérer est l'un des ancêtres de ce nœud ou ce nœud lui-même.

DOM_WRONG_DOCUMENT_ERR

Levée si l'un des nodes transmis a été créé à partir d'un document différent de celui qui a créé ce nœud.

Historique

Version Description
8.3.0 Appeler cette méthode sur un nœud sans parent est désormais sans effet pour aligner le comportement sur la spécification du DOM. Auparavant, cela déclenchait une DOMException avec le code DOM_HIERARCHY_REQUEST_ERR.

Exemples

Exemple #1 Exemple de DOMCharacterData::before()

Ajoute les nœuds avant les données.

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container><![CDATA[world]]></container>");
$cdata = $doc->documentElement->firstChild;

$cdata->before("hello", $doc->createElement("beautiful"));

echo
$doc->saveXML();
?>

L'exemple ci-dessus va afficher :

<?xml version="1.0"?>
<container>hello<beautiful/><![CDATA[world]]></container>

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top