# 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](/docs/es/installation/) y guarda el siguiente módulo completo como `main.ts`.

## Aplica Fire

[Sección titulada «Aplica Fire»](#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.

```ts
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](#unavailable-output).

[Vista previa interactiva del efecto: abre la página](https://domfx.dev/docs/es/standalone/)

## Usa otro efecto

[Sección titulada «Usa otro efecto»](#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](/docs/es/api/effects/) comienza con la misma vista previa interactiva, y la [galería](/es/effects/) los compara uno junto a otro.

## Controla el tiempo y la intensidad

[Sección titulada «Controla el tiempo y la intensidad»](#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](/docs/es/api/shared/#control-playback).

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»](#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](/docs/es/frameworks/).

## Salida no disponible

[Sección titulada «Salida no disponible»](#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](/docs/es/troubleshooting/) para ver los códigos de motivo y cómo recuperarse.
