jQuery
Aggiungere
Ricerca…
Sintassi
- $ (Selector) .Append (contenuto)
- $ (Contenuto) .appendTo (selettore)
Parametri
parametri | Dettagli |
---|---|
soddisfare | Tipi possibili: elemento, stringa HTML, testo, matrice, oggetto o anche una funzione che restituisce una stringa. |
Osservazioni
.append () e .after () possono potenzialmente eseguire codice. Ciò può verificarsi mediante l'iniezione di tag di script o l'uso di attributi HTML che eseguono codice (ad esempio,). Non utilizzare questi metodi per inserire stringhe ottenute da fonti non attendibili come parametri di query URL, cookie o input di moduli. In tal modo è possibile introdurre vulnerabilità cross-site-scripting (XSS). Rimuovi o esci da qualsiasi input dell'utente prima di aggiungere il contenuto al documento.
jQuery non supporta ufficialmente SVG. Utilizzo dei metodi jQuery su SVG
i documenti, se non esplicitamente documentati per quel metodo, potrebbero causare comportamenti imprevisti. Esempi di metodi che supportano SVG a partire da
jQuery 3.0 sono addClass e removeClass.
Aggiunta di un elemento a un contenitore
Soluzione 1:
$('#parent').append($('#child'));
Soluzione 2:
$('#child').appendTo($('#parent'));
Entrambe le soluzioni #child
l'elemento #child
(aggiungendo alla fine) all'elemento #parent
.
Prima:
<div id="parent">
<span>other content</span>
</div>
<div id="child">
</div>
Dopo:
<div id="parent">
<span>other content</span>
<div id="child">
</div>
</div>
Nota: quando si aggiunge un contenuto già esistente nel documento, questo contenuto verrà rimosso dal contenitore principale originale e aggiunto al nuovo contenitore principale. Quindi non puoi usare .append()
o .appendTo()
per clonare un elemento. Se hai bisogno di un clone usa .clone()
-> [ http://api.jquery.com/clone/][1]
Efficiente utilizzo consecutivo .append ()
Inziando:
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" }
];
Aggiunta all'interno di un ciclo
Hai appena ricevuto una grande quantità di dati. Ora è il momento di scorrere e renderlo sulla pagina.
Il tuo primo pensiero potrebbe essere quello di fare qualcosa di simile:
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)
)
);
}
Questo è perfettamente valido e renderà esattamente ciò che ti aspetteresti, ma ...
Non farlo.
Ricorda quelle oltre 300 righe di dati?
Ognuno costringerà il browser a ricalcolare i valori di larghezza, altezza e posizionamento di ogni elemento, insieme a qualsiasi altro stile, a meno che non siano separati da un limite di layout , che sfortunatamente per questo esempio (dato che sono discendenti di un elemento <table>
), loro non possono.
A piccole quantità e poche colonne, questa penalità di prestazioni sarà certamente trascurabile. Ma vogliamo contare ogni millisecondo.
Migliori opzioni
Aggiungi a un array separato, aggiungi dopo il completamento del ciclo
/**
* 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);
Di queste opzioni, questa si basa su jQuery di più.
Uso dei moderni metodi 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);
Funzionalmente equivalente a quello precedente, solo più facile da leggere.
Utilizzo di stringhe di HTML (invece dei metodi incorporati di 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(''));
Perfettamente valido ma ancora, non raccomandato . Ciò impone a jQuery di analizzare una grande quantità di testo in una sola volta e non è necessario. jQuery è molto bravo in quello che fa se usato correttamente.
Crea manualmente gli elementi, aggiungi al frammento 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);
Il mio preferito . Questo illustra un'idea generale di ciò che jQuery fa a un livello inferiore.
Tuffati più a fondo
- jQuery viewer di origine
- Array.prototype.join ()
- Array.prototype.map ()
- Array.prototype.reduce ()
- document.createDocumentFragment ()
- document.createTextNode ()
- Nozioni di base sul Web di Google: prestazioni
jQuery append
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>
copione
$("#btn-1").click(function(){
$("p").append(" <b>Book</b>.");
});
$("#btn-2").click(function(){
$("ul").append("<li>Appended list item</li>");
});
});