Uso independiente
Aplica un efecto, controla su animación y ajusta un ejemplo interactivo de Fire.
Añade llamas animadas a un botón sin cambiar su interacción. Crea primero los archivos de la guía de instalación y guarda el siguiente módulo completo como main.ts.
Aplica Fire
Sección titulada «Aplica Fire»clock: ‘auto’ hace avanzar el tiempo del efecto. La limpieza se registra antes de esperar las fuentes y preparar Fire, por lo que salir durante la carga no crea un efecto tardío.
import { attachFire } from '@domfx/browser';
const host = document.querySelector('#host');
const target = document.querySelector('#target');
const clicks = document.querySelector('#clicks');
if (!(host instanceof HTMLElement) || !target || !clicks) {
throw new Error('Falta el contenedor, el objetivo o el contador');
}
let count = 0;
const onClick = () => { clicks.textContent = String(++count); };
target.addEventListener('click', onClick);
let disposed = false;
let fire: ReturnType<typeof attachFire> | undefined;
function cleanup() {
disposed = true;
window.removeEventListener('pagehide', cleanup);
target?.removeEventListener('click', onClick);
fire?.dispose();
}
// Antes de llamar a setup, registra también cleanup para que se ejecute al desmontar el componente.
window.addEventListener('pagehide', cleanup, { once: true });
const setup = async () => {
await document.fonts.ready;
if (disposed) { return; }
fire = attachFire(target, {
host, clock: 'auto', motion: 'respect',
intensity: 0.8, seed: 314,
});
await fire.ready;
if (!disposed && fire.lifecycle !== 'active') {
console.info(fire.reason);
}
};
void setup();Ejecuta pnpm dev y abre la URL local indicada. Verás llamas alrededor del botón; al pulsarlo, aumenta el contador. Para probar la compilación de producción, ejecuta pnpm build y después pnpm preview.
Si no aparece el efecto, el botón sigue funcionando. Consulta el motivo en la consola y la sección Salida no disponible.
Ajusta el efecto
El alcance de las llamas es una fracción de la altura del objetivo. Cambiarlo vuelve a crear el efecto; la intensidad cambia la fuerza visual. El texto original sigue siendo seleccionable.

Pasa el cursor para explorarAmplía para explorar Enfoca la vista previa: + y − amplían o reducen, las flechas desplazan y 0 restablece. En pantallas táctiles, arrastra para desplazar.
La vista previa necesita JavaScript y WebGPU.
import { attachFire } from '@domfx/browser';
const effect = attachFire(target, {
host,
clock: 'auto',
intensity: 0.8,
seed: 314,
flameReach: 0.2,
emberDensity: 1,
});
// Al desmontar: effect.dispose();Usa otro efecto
Sección titulada «Usa otro efecto»Sustituye attachFire por una función como attachFrost o attachDither y usa sus opciones de creación. flameReach es exclusivo de Fire. El tiempo, la intensidad y los métodos de la instancia son compartidos; la intensidad depende del efecto y del modo de tamaño elegidos.
Libera el efecto existente antes de aplicar otro al mismo objetivo. Cada referencia de efecto comienza con la misma vista previa interactiva, y la galería los compara uno junto a otro.
Controla el tiempo y la intensidad
Sección titulada «Controla el tiempo y la intensidad»fire.pause() pausa la animación automática. fire.resume() continúa sin avanzar de golpe el tiempo transcurrido mientras estaba en pausa u oculto. Asigna a fire.intensity un valor entre 0 y 1. Consulta los valores admitidos en la referencia de controles.
Para elegir un tiempo explícito, usa clock: ‘manual’ al crear el efecto y asigna segundos absolutos a fire.time. Avanzar y retroceder reutiliza la captura. Con control externo, paused sigue siendo true aunque cambie el tiempo; resume() no lo avanza.
Actualiza la captura y libera recursos
Sección titulada «Actualiza la captura y libera recursos»Después de cambiar la apariencia capturada, espera a fire.refresh(). Oculta la salida obsoleta y se resuelve cuando se acepta esta captura u otra posterior. Los cambios detectados en el objetivo y su tamaño pueden actualizarla automáticamente; los cambios no detectados en hojas de estilo, estados de hover o la apariencia de los elementos antecesores requieren una actualización explícita.
Actualizar la captura no omite la caché de imágenes. Si el contenido de una imagen cambia, usa una URL versionada o cabeceras de caché del servidor que exijan revalidación.
Llama a cleanup() al desmontar el componente; pagehide solo cubre la salida de la página. Puedes llamarla varias veces, incluso mientras esperas las fuentes o ready. Regístrala de forma síncrona en el mecanismo de limpieza de tu framework antes de llamar a setup(). Al volver a montar, ejecuta de nuevo el código con variables y elementos nuevos; un efecto liberado no se puede reutilizar. En React o Vue, copia las recetas probadas.
Salida no disponible
Sección titulada «Salida no disponible»ready se resuelve después de un intento, incluso si el entorno no permite el efecto. Consulta fire.lifecycle, fire.raster y fire.reason. Mantén disponible el contenido original. Tras corregir la condición, espera explícitamente a fire.retry() y vuelve a consultar el resultado.
El valor predeterminado motion: ‘respect’ suprime la salida con movimiento reducido. Volver a cambiar la preferencia exige un reintento explícito. motion: ‘static’ permite una decoración inmóvil en el tiempo cero; nunca impone animación sobre la preferencia de movimiento reducido.
Consulta solución de problemas para ver los códigos de motivo y cómo recuperarse.