Star shimmer
Pequeños destellos en forma de estrella brillan a lo largo del borde.

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 { attachStarShimmer } from '@domfx/browser';
const effect = attachStarShimmer(target, {
host,
clock: 'auto',
intensity: 0.8,
seed: 314,
plumeReach: 0.1,
bandDepth: 0.05,
});
// Al desmontar: effect.dispose();- Categoría
- Patrón
- Función
attachStarShimmer- Opciones
PatternOptions- Paquete
@domfx/browser
Uso
attachStarShimmer(target: Element, options: PatternOptions): ColorEffectHandle
Devuelve una instancia de efecto de inmediato. Las importaciones son seguras durante el renderizado en servidor; llama a la función en el navegador después de montar los elementos. La guía de uso independiente incluye el HTML y CSS necesarios.
import { attachStarShimmer } from '@domfx/browser';
import type { PatternOptions } from '@domfx/browser';
// Ejecuta después del montaje; host contiene target y tiene position: relative.
const options: PatternOptions = {
host, clock: 'auto', intensity: 0.8,
plumeReach: 0.1,
bandDepth: 0.05,
};
const effect = attachStarShimmer(target, options);
// Llama también a effect.dispose() al desmontar el componente.
window.addEventListener('pagehide', () => effect.dispose(), { once: true });
await effect.ready;
if (effect.lifecycle !== 'active') {
console.info(effect.reason, effect.reasonDetail);
}Opciones del efecto
Estas opciones se fijan al crear la instancia. Son fracciones numéricas finitas y no negativas del borde del elemento objetivo, antes de transformar y sin incluir el relleno de captura. Los márgenes transparentes de las imágenes cuentan; no se usan los límites ajustados de los píxeles visibles. Se calculan otra vez cuando cambia el tamaño del objetivo. Cambiar una opción requiere otra instancia.
| Propiedad | Tipo y unidad | Ejemplo |
|---|---|---|
plumeReachAlcance ascendente | number · fracción de la altura física local | 0.1 = 10% |
bandDepthProfundidad de la banda interior | number · fracción del lado local más corto | 0.05 = 5% |
Omitir todas las opciones de extensión conserva la apariencia predeterminada, incluida su relación con intensity. Al proporcionar una opción se activa el modo relativo: intensity escala la salida premultiplicada sin cambiar los emisores, la cuadrícula, las marcas ni su separación. El valor cero produce una salida transparente cuando todas las extensiones son cero.
plumeReach fija el recorrido ascendente de los emisores; bandDepth fija la cobertura interior. En modo relativo, la opción que falte vale cero y desactiva ese componente. Por ejemplo, plumeReach: 0.1 representa 10 píxeles CSS en un objetivo de 100px de alto y 40 en uno de 400px. Las marcas mantienen su escala local: Dither conserva los puntos finos y su cuadrícula de 2px.
El alcance es una envolvente permitida, no una punta visible garantizada. Las marcas que se muestrean cerca del borde pueden sobresalir de ella; se reservan 6 píxeles CSS para cubrir todas las marcas, además del margen de muestreo. La opacidad puede cambiar los límites visibles al aplicar un umbral.
El modo relativo requiere descendientes contenidos, sin sombras, filtros, contornos CSS ni pseudo-elementos generados, y pintura dentro del borde del objetivo más 2 píxeles CSS. Se comprueba la pintura real y todo el margen exterior. El DPR cambia la resolución y la admisión, no la fracción CSS. Los límites de captura y memoria siguen vigentes: las solicitudes que no caben dejan el efecto no disponible, sin recortar ni reducir su calidad. El contenido original sigue utilizable.
Opciones compartidas
Usa el tipo exportado AttachmentOptions. Solo host es obligatorio. Los efectos salvo Burned paper amplían este tipo con ColorAttachmentOptions.
| Propiedad | Tipo | Predeterminado |
|---|---|---|
hostContenedor del efecto: un elemento HTML ya presente en la página, con una posición CSS distinta de static. Debe contener el elemento objetivo en el mismo documento; no puede ser el propio objetivo. | HTMLElement | Obligatorio |
clockUsa manual para controlar el tiempo con tu código o GSAP; auto lo avanza automáticamente. | 'manual' | 'auto' | 'manual' |
motionrespect suprime la salida con movimiento reducido. static siempre dibuja un efecto inmóvil en el tiempo cero, con cualquier preferencia. | 'respect' | 'static' | 'respect' |
seedSemilla aleatoria fija. Permite repetir el patrón con el mismo tiempo, ajustes y objetivo capturado. No determina la cantidad de aleatoriedad ni garantiza píxeles idénticos entre dispositivos. | number | 0 |
timeTiempo inicial del efecto en segundos. Acepta valores negativos. | number | 0 |
intensityIntensidad inicial del efecto. Los valores aceptados se limitan al intervalo de 0 a 1; la respuesta visual depende del efecto. | number | 1 |
colorColor decorativo principal opcional para todos los efectos excepto Burned paper. Acepta #RGB, #RRGGBB, rgb(...) y rgba(..., 1). Omitirlo conserva los colores originales del efecto; asignar undefined los restaura. | string | undefined | Omitido (colores originales) |
Todos los valores numéricos deben ser finitos. time, seed, intensity y los controles solo de creación deben ser representables como float32. Los controles artísticos modificables, incluso al crearlos, aceptan cualquier número finito y se limitan a 0–1; los demás valores no válidos generan un error antes de aplicar el límite. Para cambiar una opción de creación distinta de time o intensity, libera la instancia y crea otra.
Solo un efecto puede usar un objetivo a la vez. Las relaciones de contenedor no válidas y los objetivos superpuestos generan un error síncrono. Libera el efecto existente antes de aplicar otro al mismo objetivo, a uno de sus ancestros o a uno de sus descendientes. Esta restricción se refiere al árbol del DOM, no a cualquier superposición visual.
Controles
Sin opciones de extensión: Refuerza el patrón y amplía su alcance. En modo relativo, intensity escala la opacidad sin cambiar la extensión ni las marcas.
Lee y modifica estas propiedades de la instancia de efecto. Los cambios pueden leerse de inmediato. Cuando la salida está disponible, se dibujan en el siguiente fotograma sin volver a capturar el elemento.
| Propiedad | Tipo |
|---|---|
timeTiempo del efecto en segundos. Permite avanzar y retroceder, incluso a tiempos negativos. | number |
intensityIntensidad del efecto, limitada al intervalo de 0 a 1 después de validar el valor. No es un ajuste universal de altura ni de opacidad. | number |
colorColor decorativo principal opcional. Todos los efectos excepto Burned paper lo admiten; asigna undefined para recuperar los colores originales. | string | undefined |
Todos los valores numéricos deben ser finitos. time e intensity deben ser representables como float32. intensity y los controles específicos se limitan a 0–1; estos últimos aceptan cualquier número finito. Una asignación no válida genera un error y conserva el valor anterior. Usa un solo controlador por propiedad: asignaciones directas, una línea de tiempo u otro controlador de animación.
Consulta la sección sobre animación automática y control externo y la guía de GSAP. La referencia de la instancia de efecto documenta el estado, las actualizaciones de captura y la liberación de recursos.
Límites
El efecto sigue la forma visible capturada, incluidos los huecos y las regiones separadas. Una imagen opaca tiene una forma rectangular. La capa decorativa conserva intacto el contenido original.
Solo las opciones enumeradas son públicas. Todos los efectos salvo Burned paper permiten configurar un color decorativo principal; los degradados, la cantidad de partículas y el procesamiento del elemento completo no se pueden configurar. Mantén utilizable el contenido original cuando la salida no esté disponible. Para los límites de WebGPU, captura y composición, consulta compatibilidad con navegadores y solución de problemas.
Más efectos de patrón
- DitherPuntos ordenados cubren el borde y forman estelas ascendentes.
attachDither - HalftonePuntos de semitono siguen el borde visible.
attachHalftone - StipplePuntos dispersos siguen la forma visible.
attachStipple - ScanlinesBandas horizontales finas se mueven a lo largo del borde.
attachScanlines - CrosshatchLíneas cruzadas forman un entramado a lo largo del borde.
attachCrosshatch - Diamond latticeUna retícula de rombos sigue la forma visible.
attachDiamonds - Contour echoesContornos sucesivos repiten el borde de la forma visible.
attachContourEchoes - EngravingLíneas finas grabadas dan textura al borde.
attachEngraving - Woven meshHilos entrelazados crean una textura tejida en el borde.
attachWovenMesh - HexagonsUna retícula hexagonal sigue la forma visible.
attachHexagons - InterferenceOndas superpuestas forman un patrón de interferencia alrededor del borde.
attachInterference - ShardsFragmentos angulares se agrupan a lo largo del borde.
attachShards - CircuitsTrazos semejantes a circuitos siguen la forma visible.
attachCircuits - Brush fringePinceladas forman una franja alrededor de la forma visible.
attachBrushFringe
Compara todos los efectos en la galería, uno junto a otro.