PHP 8.6.0 RC5 available for testing

Dom\Element::insertAdjacentHTML

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

Dom\Element::insertAdjacentHTML — Analiza un string como HTML o XML e inserta el resultado en una posición dada

Descripción

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

Analiza string como un fragmento e inserta los nodos resultantes en la posición indicada por where, en relación con este elemento. El fragmento se analiza como HTML en un documento HTML, y como XML en un documento XML.

Parámetros

where

Un caso de Dom\AdjacentPosition que indica dónde se insertan los nodos en relación con este elemento.

string

El marcado HTML o XML a analizar. En un documento XML, debe ser un fragmento XML bien formado.

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

Lanza una DOMException con el código Dom\NO_MODIFICATION_ALLOWED_ERR si where es Dom\AdjacentPosition::BeforeBegin o Dom\AdjacentPosition::AfterEnd y este elemento no tiene padre, o su padre es el documento.

Lanza una DOMException con el código Dom\SYNTAX_ERR si este elemento está en un documento XML y string no es un fragmento XML bien formado.

Ejemplos

Ejemplo #1 Ejemplo 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";

El ejemplo anterior mostrará:

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

Véase también

+add a note

User Contributed Notes

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