Resumen
Agrega un nuevo nodo al final de la lista de un elemento hijo de un elemento padre especificado. Si el nodo ya existe, es eliminado del actual nodo padre, para posteriormente ser agregado al nuevo nodo padre.
Sintaxis
var child = element.appendChild(child);
element
es el elemento padre.child
es el nodo a agregar por debajo deelement
. También regresado.
Descripción
El método appendChild
regresa una referencia al nodo agregado.
Ejemplo
// Crea un nuevo elemento párrafo, y lo agrega al final del cuerpo del documento var p = document.createElement("p"); document.body.appendChild(p);
Notas
Si el child
hace una referencia a un nodo existente en el documento, el método appendChild
se mueve de su posición actual a su nueva posición (ej. no existen requerimientos para eliminar el nodo desde su nodo padre antes de añadirlo a cualquier otro nodo).
Ésto significa también que el nodo no puede estar en dos puntos del documento de manera simultánea. Así que si el nodo ya contiene un padre, primero es eliminado, y después se añade a la nueva posición.
Se puede usar Node.cloneNode
para hacer una copia del nodo antes de añadirlo debajo de su nuevo elemento padre. (Nota: las copias echas con cloneNode
no serán guardadas automáticamente en sincronía.)
Éste método no es permitido para mover nodos entre distintos documentos. Si se quiere añadir un nodo desde un documento diferente (por ejemplo para mostrar los resultados de una petición AJAX) se debe usar primero:
document.importNode
.
appendChild()
Es uno de los métodos fundamentales de la programación web usando el DOM. El método appendChild()
inserta un nuevo nodo dentro de la estructura DOM de un documento, y es la segunda parte del proceso central uno-dos, crear-y-añadir para construir páginas web a base de programación.