Ir al contenido

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.

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.

domfx

La vista previa necesita JavaScript y WebGPU.

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.

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.

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.

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.