jQuery
Adjuntar
Buscar..
Sintaxis
- $ (selector) .append (contenido)
- $ (contenido) .appendTo (selector)
Parámetros
Parámetros | Detalles |
---|---|
contenido | Tipos posibles: Elemento, cadena HTML, texto, matriz, objeto o incluso una función que devuelve una cadena. |
Observaciones
.append () & .after () puede potencialmente ejecutar código. Esto puede ocurrir mediante la inyección de etiquetas de script o el uso de atributos HTML que ejecutan código (por ejemplo,). No utilice estos métodos para insertar cadenas obtenidas de fuentes no confiables, como parámetros de consulta de URL, cookies o entradas de formularios. Si lo hace, puede introducir vulnerabilidades de scripts entre sitios (XSS). Elimine o elimine cualquier entrada del usuario antes de agregar contenido al documento.
jQuery no soporta oficialmente SVG. Usando métodos jQuery en SVG
Los documentos, a menos que estén documentados explícitamente para ese método, pueden causar comportamientos inesperados. Ejemplos de métodos que soportan SVG a partir de
jQuery 3.0 son addClass y removeClass.
Anexando un elemento a un contenedor
Solución 1:
$('#parent').append($('#child'));
Solución 2:
$('#child').appendTo($('#parent'));
Ambas soluciones están agregando el elemento #child
(agregando al final) al elemento #parent
.
Antes de:
<div id="parent">
<span>other content</span>
</div>
<div id="child">
</div>
Después:
<div id="parent">
<span>other content</span>
<div id="child">
</div>
</div>
Nota: cuando agregue contenido que ya exista en el documento, este contenido se eliminará de su contenedor principal original y se agregará al nuevo contenedor principal. Por lo tanto, no puede utilizar .append()
o .appendTo()
para clonar un elemento. Si necesita un clon, use .clone()
-> [ http://api.jquery.com/clone/◆◆1]
Uso eficiente y consecutivo de .append ()
Empezando:
HTML
<table id='my-table' width='960' height='500'></table>
JS
var data = [
{ type: "Name", content: "John Doe" },
{ type: "Birthdate", content: "01/01/1970" },
{ type: "Salary", content: "$40,000,000" },
// ...300 more rows...
{ type: "Favorite Flavour", content: "Sour" }
];
Anexando dentro de un bucle
Acabas de recibir una gran variedad de datos. Ahora es el momento de recorrer y renderizarlo en la página.
Tu primer pensamiento puede ser hacer algo como esto:
var i; // <- the current item number
var count = data.length; // <- the total
var row; // <- for holding a reference to our row object
// Loop over the array
for ( i = 0; i < count; ++i ) {
row = data[ i ];
// Put the whole row into your table
$('#my-table').append(
$('<tr></tr>').append(
$('<td></td>').html(row.type),
$('<td></td>').html(row.content)
)
);
}
Esto es perfectamente válido y representará exactamente lo que esperas, pero ...
No hagas esto.
¿Recuerdas esas más de 300 filas de datos?
Cada uno forzará al navegador a volver a calcular el ancho, la altura y los valores de posicionamiento de cada elemento, junto con cualquier otro estilo, a menos que estén separados por un límite de diseño , que desafortunadamente para este ejemplo (ya que son descendientes de un elemento <table>
), ellos no pueden.
En cantidades pequeñas y pocas columnas, esta penalización de rendimiento será sin duda despreciable. Pero queremos que cada milisegundo cuente.
Mejores opciones
Agregar a una matriz separada, agregar después de que se complete el bucle
/**
* Repeated DOM traversal (following the tree of elements down until you reach
* what you're looking for - like our <table>) should also be avoided wherever possible.
*/
// Keep the table cached in a variable then use it until you think it's been removed
var $myTable = $('#my-table');
// To hold our new <tr> jQuery objects
var rowElements = [];
var count = data.length;
var i;
var row;
// Loop over the array
for ( i = 0; i < count; ++i ) {
rowElements.push(
$('<tr></tr>').append(
$('<td></td>').html(row.type),
$('<td></td>').html(row.content)
)
);
}
// Finally, insert ALL rows at once
$myTable.append(rowElements);
De estas opciones, esta es la que más confía en jQuery.
Usando métodos modernos de Array. *
var $myTable = $('#my-table');
// Looping with the .map() method
// - This will give us a brand new array based on the result of our callback function
var rowElements = data.map(function ( row ) {
// Create a row
var $row = $('<tr></tr>');
// Create the columns
var $type = $('<td></td>').html(row.type);
var $content = $('<td></td>').html(row.content);
// Add the columns to the row
$row.append($type, $content);
// Add to the newly-generated array
return $row;
});
// Finally, put ALL of the rows into your table
$myTable.append(rowElements);
Funcionalmente equivalente al anterior, solo más fácil de leer.
Uso de cadenas de HTML (en lugar de los métodos incorporados de jQuery)
// ...
var rowElements = data.map(function ( row ) {
var rowHTML = '<tr><td>';
rowHTML += row.type;
rowHTML += '</td><td>';
rowHTML += row.content;
rowHTML += '</td></tr>';
return rowHTML;
});
// Using .join('') here combines all the separate strings into one
$myTable.append(rowElements.join(''));
Perfectamente válido pero de nuevo, no recomendado . Esto obliga a jQuery a analizar una gran cantidad de texto a la vez y no es necesario. jQuery es muy bueno en lo que hace cuando se usa correctamente.
Crear elementos manualmente, añadir al fragmento del documento.
var $myTable = $(document.getElementById('my-table'));
/**
* Create a document fragment to hold our columns
* - after appending this to each row, it empties itself
* so we can re-use it in the next iteration.
*/
var colFragment = document.createDocumentFragment();
/**
* Loop over the array using .reduce() this time.
* We get a nice, tidy output without any side-effects.
* - In this example, the result will be a
* document fragment holding all the <tr> elements.
*/
var rowFragment = data.reduce(function ( fragment, row ) {
// Create a row
var rowEl = document.createElement('tr');
// Create the columns and the inner text nodes
var typeEl = document.createElement('td');
var typeText = document.createTextNode(row.type);
typeEl.appendChild(typeText);
var contentEl = document.createElement('td');
var contentText = document.createTextNode(row.content);
contentEl.appendChild(contentText);
// Add the columns to the column fragment
// - this would be useful if columns were iterated over separately
// but in this example it's just for show and tell.
colFragment.appendChild(typeEl);
colFragment.appendChild(contentEl);
rowEl.appendChild(colFragment);
// Add rowEl to fragment - this acts as a temporary buffer to
// accumulate multiple DOM nodes before bulk insertion
fragment.appendChild(rowEl);
return fragment;
}, document.createDocumentFragment());
// Now dump the whole fragment into your table
$myTable.append(rowFragment);
Mi favorito personal . Esto ilustra una idea general de lo que hace jQuery en un nivel inferior.
Bucear más profundo
- Visor de fuente jQuery
- Array.prototype.join ()
- Array.prototype.map ()
- Array.prototype.reduce ()
- document.createDocumentFragment ()
- document.createTextNode ()
- Fundamentos de Google Web - Rendimiento
jQuery anexar
HTML
<p>This is a nice </p>
<p>I like </p>
<ul>
<li>List item 1</li>
<li>List item 2</li>
<li>List item 3</li>
</ul>
<button id="btn-1">Append text</button>
<button id="btn-2">Append list item</button>
Guión
$("#btn-1").click(function(){
$("p").append(" <b>Book</b>.");
});
$("#btn-2").click(function(){
$("ul").append("<li>Appended list item</li>");
});
});