Manuale PHP
Indietro |  | Avanti

# DOMDocument->createElement()

(no version information, might be only in CVS)

DOMDocument->createElement() -- Crea un nuovo nodo elemento

## Descrizione

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

Questa funzione crea una nuova istanza della classe DOMElement. This node will not show up in the document unless it is inserted with e.g. DOMNode->appendChild().

## Elenco dei parametri

name

  Il nome del tag dell'elemento.

value

  Il valore dell'elemento. Per default si crea un elemento vuoto. Il valore può essere impostato in un secondo momento tramite DOMElement->nodeValue.

## Valori restituiti

Restituisce una nuova istanza della classe DOMElement oppure `FALSE` in caso di errore.

## Eccezioni

`DOM_INVALID_CHARACTER_ERR`

  Generato se name contiene caratteri invalidi.

## Esempi

Esempio 1. Esempio di creazione di un nuovo elemento ed inserimento nel documento come root

`<?php $dom = new DOMDocument('1.0', 'iso-8859-1'); $element = $dom->createElement('test', 'This is the root element!'); // inserimento dell'elemento come root (figlio del nodo documento) $dom->appendChild($element); echo $dom->saveXML(); ?>`

Il precedente esempio visualizzerà:

    <?xml version="1.0" encoding="iso-8859-1"?>
    <test>This is the root element!</test>

## Vedere anche:

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

Indietro | Partenza | Avanti
DOMDocument->createDocumentFragment() | Risali | DOMDocument->createElementNS()