Buscar..


Sintaxis

  1. $ (selector) .append (contenido)
  2. $ (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

  1. 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.


  1. 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.


  1. 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.


  1. 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

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>");
 });
});


Modified text is an extract of the original Stack Overflow Documentation
Licenciado bajo CC BY-SA 3.0
No afiliado a Stack Overflow