array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'tr', ), 'this' => array ( 0 => 'domdocument.createelement.php', 1 => 'DOMDocument::createElement', 2 => 'Yeni bir eleman düğümü oluşturur', ), 'up' => array ( 0 => 'class.domdocument.php', 1 => 'DOMDocument', ), 'prev' => array ( 0 => 'domdocument.createdocumentfragment.php', 1 => 'DOMDocument::createDocumentFragment', ), 'next' => array ( 0 => 'domdocument.createelementns.php', 1 => 'DOMDocument::createElementNS', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'tr', 'path' => 'reference/dom/domdocument/createelement.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DOMDocument::createElement

(PHP 5, PHP 7, PHP 8)

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

Açıklama

public DOMDocument::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