PHP 8.6.0 RC5 available for testing

Dom\Element::insertAdjacentHTML

(No version information available, might only be in Git)

Dom\Element::insertAdjacentHTML — Analyse une chaîne en HTML ou en XML et insère le résultat à une position donnée

Description

public function Dom\Element::insertAdjacentHTML(Dom\AdjacentPosition $where, string $string): void

Analyse string comme un fragment et insère les nœuds obtenus à la position donnée par where, par rapport à cet élément. Le fragment est analysé en HTML dans un document HTML, et en XML dans un document XML.

Liste de paramètres

where

Un cas de Dom\AdjacentPosition qui indique où les nœuds sont insérés par rapport à cet élément.

string

Le balisage HTML ou XML à analyser. Dans un document XML, il doit s'agir d'un fragment XML bien formé.

Valeurs de retour

Aucune valeur n'est retournée.

Erreurs / Exceptions

Lève une DOMException avec le code Dom\NO_MODIFICATION_ALLOWED_ERR si where vaut Dom\AdjacentPosition::BeforeBegin ou Dom\AdjacentPosition::AfterEnd et que cet élément n'a pas de parent, ou que son parent est le document.

Lève une DOMException avec le code Dom\SYNTAX_ERR si cet élément se trouve dans un document XML et que string n'est pas un fragment XML bien formé.

Exemples

Exemple #1 Exemple de Dom\Element::insertAdjacentHTML()

<?php

$dom = Dom\HTMLDocument::createFromString(
    '<!DOCTYPE html><body><ul id="list"><li>Two</li></ul></body>',
    LIBXML_NOERROR
);

$list = $dom->getElementById('list');

$list->firstElementChild->insertAdjacentHTML(
    Dom\AdjacentPosition::BeforeBegin,
    '<li>One</li>'
);
$list->insertAdjacentHTML(
    Dom\AdjacentPosition::BeforeEnd,
    '<li>Three</li><li><b>Four</b></li>'
);

echo $list->outerHTML, "\n";

L'exemple ci-dessus va afficher :

<ul id="list"><li>One</li><li>Two</li><li>Three</li><li><b>Four</b></li></ul>

Voir aussi

+add a note

User Contributed Notes

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