Руководство по PHP
Пред. |  | След.

# DOMDocument->createElement()

DOMDocument->createElement() -- Create new element node

## Описание

class DOMDocument {
DOMElement createElement ( string name [, string value] )
}

This function creates a new instance of class DOMElement. Этот узел не будет отображаться в документе до тех пор, пока он не будет вставлен, к пример функцией DOMNode->appendChild().

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

name

  The tag name of the element.

value

  The value of the element. By default, an empty element will be created. You can also set the value later with DOMElement->nodeValue.

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

Returns a new instance of class DOMElement or `FALSE` if an error occured.

## Исключения

`DOM_INVALID_CHARACTER_ERR`

  Raised if name contains an invalid character.

## Примеры

Пример 1. Creating a new element and inserting it as root
`<?php $dom = new DOMDocument('1.0', 'iso-8859-1'); $element = $dom->createElement('test', 'This is the root element!'); // We insert the new element as root (child of the document) $dom->appendChild($element); echo $dom->saveXML(); ?>`
Результат выполнения данного примера:
    <?xml version="1.0" encoding="iso-8859-1"?>
    <test>This is the root element!</test>

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

DOMNode->appendChild()
DOMDocument->createAttribute()
DOMDocument->createAttributeNS()
DOMDocument->createCDATASection()
DOMDocument->createComment()
DOMDocument->createDocumentFragment()
DOMDocument->createElementNS()
DOMDocument->createEntityReference()
DOMDocument->createProcessingInstruction()
DOMDocument->createTextNode()

Пред. | Начало | След.
DOMDocument->createDocumentFragment() | Уровень выше | DOMDocument->createElementNS()