element.replace(newContent: string | HTMLElement): void
| Parámetro / Paso | Tipo · Comportamiento | Descripción |
|---|---|---|
| newContentrequerido | string | HTMLElement defecto: — |
Cadena HTML o nodo HTMLElement que representa el nuevo estado del elemento. |
| updateAttributesinterno | diff de atributos defecto: automático |
Añade, actualiza o retira únicamente los atributos que han cambiado. |
| updateChildreninterno | reconciliación defecto: recursivo |
Recorre childNodes por posición, actualiza nodos de texto y respeta elementos existentes. |
| script handlinginterno | <script> defecto: activo |
Solo re-ejecuta etiquetas <script> nuevas o cuyo src/textContent haya cambiado. |
Cómo funciona element.replace(newContent)
Al incluir src/replace.js (o el punto de entrada EasyJS.js), cada elemento del DOM dispone de .replace(). Acepta tanto un string HTML como un HTMLElement ya construido.
Secuencia de reconciliación
- Etiqueta raíz distinta: si el
tagNamecambia (por ejemplo<div>por<span>), realiza una sustitución directa conreplaceWith(). - Atributos: elimina los atributos ausentes y actualiza solo aquellos cuyo valor cambió.
- Hijos recursivos: actualiza nodos de texto in-place, añade los nuevos, retira los sobrantes y trata etiquetas
<script>nuevas o modificadas para ejecutarlas correctamente.
const panel = document.getElementById('panel');
panel.replace(`
<div id="panel" class="updated">
<h2>Estado en vivo</h2>
<input type="text" placeholder="Tu texto sigue intacto" />
</div>
`);