Edit Report a Bug

    DOMElement::before

    (PHP 8)

    DOMElement::before — Добавляет узлы перед элементом

    Описание

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

    Добавляет переданные узлы nodes перед элементом.

    Список параметров

    nodes

    Узлы, которые необходимо добавить перед узлом. Строки автоматически преобразуются в текстовые узлы.

    Возвращаемые значения

    Функция не возвращает значения после выполнения.

    Ошибки

    DOM_HIERARCHY_REQUEST_ERR

    Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе родительского узла, или если добавляемый узел является одним из предков этого узла или самим этим узлом.

    DOM_WRONG_DOCUMENT_ERR

    Возникает, если один из переданных в параметре nodes элементов был создан из документа, отличного от того, в котором был создан этот узел.

    Список изменений

    Версия Описание
    8.3.0 Вызов этого метода на узле, у которого нет родительского узла, теперь ничего не делает, чтобы привести поведение в соответствие со спецификацией DOM. Ранее это выбрасывало исключение DOMException с кодом DOM_HIERARCHY_REQUEST_ERR.

    Примеры

    Пример #1 Пример использования метода DOMElement::before()

    Добавление узлов перед элементом «hello».

    <?php
    $doc     = new DOMDocument;
    $doc->loadXML("<world/>");
    $world = $doc->documentElement;

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

    echo     $doc->saveXML();
    ?>

    Результат выполнения приведённого примера: 

    hello
<beautiful/>
<world/>

    Смотрите также

    add a note add a note

    User Contributed Notes

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