DOMDocument::createElement

    (PHP 5, PHP 7, PHP 8)

    DOMDocument::createElement — Yeni bir eleman düğümü oluşturur

    Açıklama

    publicDOMDocument::createElement(string$localName, string$value = ""): DOMElement|false

    Yeni bir DOMElement nesnesi oluşturur. Bu düğüm, DomNode::append_child() gibi bir yöntemle belgeye yerleştirilmedikçe belgede gösterilmez.

    Bağımsız Değişkenler

    localName

    Elemanın etiket ismi.

    value

    Elemanın değeri. Öntanımlı olarak boş eleman oluşturulur. Değer daha sonra DOMElement::$nodeValue() ile atanabilir.

    < ve > öğe başvuruları öncelenmedikçe değer birebir kulllanılır. Dikkat: & öncelenmek zorundadır, aksi takdirde öğe başvurusunun başlangıç karakteri olarak ele alınmaz. Ayrıca, " karakteri öncelenmez.

    Dönen Değerler

    Bir hata oluşursa false yoksa yeni bir DOMElement nesnesi döner.

    Hatalar/İstisnalar

    DOM_INVALID_CHARACTER_ERR

    localName geçersiz karakter içeriyorsa oluşur.

    Örnekler

    Örnek 1 - Yeni bir eleman oluşturup belge elemanı yapmak

    <?php

    $dom     = new DOMDocument('1.0', 'utf-8');
    $element = $dom->createElement('test', 'This is the root element!');

    // Oluşturduğumuz elemanı belge elemanı yapalım
    $element->appendChild($element_ns);

    echo     $dom->saveXML();
    ?>

    Yukarıdaki örneğin çıktısı:

    <?xml version="1.0" encoding="utf-8"?> <test>This is the root element!</test>

    Örnek 2 - value olarak öncelenmemiş & içeren metin kullanmak

    <?php
    $dom     = new DOMDocument('1.0', 'utf-8');
    $element = $dom->createElement('foo', 'sen & ben');
    $dom->appendChild($element);
    echo     $dom->saveXML();
    ?>

    Yukarıdaki örnek şuna benzer bir çıktı üretir:

    Warning: DOMDocument::createElement(): unterminated entity reference ben in /in/BjTCg on line 4 <?xml version="1.0" encoding="utf-8"?> <foo/>

    Notlar

    Bilginize:

    value öncelenMEyecektir. Önceleme destekli bir metin düğümü oluşturmak istiyorsanız DOMDocument::createTextNode() kullanın.

    Ayrıca Bakınız

    To Top