PHP 8.6.0RC7 available for testing

Dom\Element::insertAdjacentHTML

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

Dom\Element::insertAdjacentHTML — Analisa uma string como HTML ou XML e insere o resultado em uma posição fornecida

Descrição

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

Analisa string como um fragmento e insere os nós resultantes na posição fornecida por where, relativa a este elemento. O fragmento é analisado como HTML em um documento HTML e como XML em um documento XML.

Parâmetros

where

Um caso de Dom\AdjacentPosition que especifica onde os nós são inseridos em relação a este elemento.

string

A marcação HTML ou XML a ser analisada. Em um documento XML, deve ser um fragmento XML bem formado.

Valor Retornado

Nenhum valor é retornado.

Erros/Exceções

Lança uma DOMException com o código Dom\NO_MODIFICATION_ALLOWED_ERR se where for Dom\AdjacentPosition::BeforeBegin ou Dom\AdjacentPosition::AfterEnd e este elemento não tiver um nó pai ou seu nó pai for o documento.

Lança uma DOMException com o código Dom\SYNTAX_ERR se este elemento estiver em um documento XML e string não for um fragmento XML bem formado.

Exemplos

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

O exemplo acima produzirá:

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

Veja também

+adicionar nota

Notas de Usuários

Não há notas de usuários para esta página.
To Top