Finsweet Class Adder
Añade y elimina clases CSS en elementos de Webflow al hacer clic, pasar el cursor, desplazarse o cargar la página mediante un script generado por el Visual Builder de Finsweet.
Cambiar una clase CSS completa en tiempo de ejecución normalmente requiere JavaScript, y una sola clase puede contener docenas de reglas de estilo a la vez. Finsweet Class Adder escribe ese JavaScript por ti a partir de un formulario visual, para que un diseñador pueda alternar una clase sin abrir un editor de código. Es una herramienta heredada: Finsweet ya no la incluye entre sus productos actuales y el sitio de demostración no se ha vuelto a publicar desde diciembre de 2023.
El script sigue funcionando porque se compila en llamadas querySelectorAll y classList estándar sin depender de un servicio alojado. Por eso, esta página está escrita para equipos que ya lo utilizan: freelancers y agencias que mantienen sitios antiguos de clientes, y equipos internos que heredaron un desarrollo en Webflow con el bloque ya pegado en el pie de página. Para cualquier proyecto nuevo, recurre primero a las interacciones nativas de Webflow.
Cómo integrar Finsweet Class Adder con Webflow
¿Qué es Finsweet Class Adder? Class Adder es un generador de código, no una librería pesada que debas cargar. Solo defines una clase activadora, una clase objetivo y la clase que quieres añadir o quitar, y ¡listo!: te devuelve un bloque de JavaScript listo para pegar en el código personalizado de tu web. Cero peticiones externas en tiempo de ejecución y sin andar leyendo atributos de tus elementos.

Los equipos recurren a esta herramienta cuando un cambio de estado afecta a muchas propiedades de estilo a la vez, ya que una clase puede contener un gran bloque de estilos que un activador aplica después. Fijar un vídeo después de que un activador se desplaza fuera de la vista, bloquear el desplazamiento del cuerpo detrás de un modal, cambiar un listado de vista de lista a cuadrícula o cambiar el tema de un sitio encajan en este caso. Cada uno es un cambio de clase, y el estilo permanece en Webflow, donde los diseñadores ya lo gestionan.
Hay dos formas de colar el script en tu web. La mayoría lo pega a mano desde el Visual Builder, la única interfaz oficial de Finsweet para configurarlo. Las agencias que usan el mismo bloque en montones de sitios de clientes pueden inyectarlo con los endpoints de código personalizado de la API de datos de Webflow, cambiando los clics visuales por pura magia en el servidor.
Pega el script del Visual Builder en el código personalizado
El Visual Builder es como un formulario mágico: indicas una clase o ID activadora, eliges cómo se dispara y sumas pares de objetivos para decidir qué clase entra o sale de cada elemento. El resultado incluye comentarios la mar de útiles si dejas la opción activa, así tu equipo entenderá de qué va cada bloque un año después. La web de demo de Finsweet repasa este flujo con seis ejemplos prácticos y sus respectivos vídeos. El bloque va directo al código del head y body de Webflow, nada de meterlo en un Code Embed sobre el lienzo.
Para configurar la integración:
- Abre el Visual Builder e introduce la clase o ID que actúa como activador.
- Elige cómo se dispara: al hacer clic, al pasar el cursor, al entrar o salir de la vista al desplazarse, o al cargar la página.
- Establece la clase o ID de destino, elige qué elementos coincidentes afecta y nombra la clase que quieres añadir o eliminar.
- Haz clic en Copy Javascript Code y llévatelo listo para usar.
- En Webflow, ve a Configuración del sitio > Código personalizado, pega en el campo Before
</body>tag, luego publica y prueba en el dominio activo.
El Visual Builder cubre estas configuraciones:
- Clic: acciones independientes para el primer y segundo clic, el secreto detrás de cualquier interruptor de dos estados.
- Hover: acciones separadas para cuando el cursor entra y cuando sale.
- Scroll: al entrar y salir del campo de visión, con un elemento raíz y un umbral para controlar exactamente cuánto debe asomarse.
- Carga de página: aplica la clase nada más renderizarse la página, sin pestañear.
- Alcance: todos los elementos con la clase objetivo, o solo los hijos, padres o hermanos del activador. Al cargar la página solo puedes apuntar a todos los elementos o a sus hermanos.
Un activador puede contener varios pares de destino, que es como un modo oscuro completo intercambia una lista de clases en una lista de elementos con un solo clic.
Añadir código a nivel de página para el bloqueo de desplazamiento en iOS
Bloquear el desplazamiento del cuerpo detrás de un modal requiere un fragmento de código adicional a nivel de página en Safari móvil, el cual Finsweet publica en la demostración de control de desplazamiento en lugar de en el resultado generado.
Para añadir el código de iOS:
- Copia el fragmento de código a nivel de página de la demostración de control de desplazamiento de Finsweet.
- En Webflow, abre la página que contiene el modal y ve a Configuración de página > Código personalizado > Antes de la etiqueta
</body></body>. - Pega el fragmento, guarda y publica.
El fragmento permanece limitado a esa página, por lo que las páginas sin un modal solo cargan el script de todo el sitio.
Entender qué hace el script generado
Leer el resultado es más importante aquí que en la mayoría de las integraciones, porque el script es el producto completo y codifica tus nombres de clase. Una regla de clic se resuelve en un querySelectorAllevento sobre la clase del activador, un clickoyente en cada coincidencia y un classList.addadd o classList.removeremove contra los destinos. Una regla de desplazamiento utiliza un IntersectionObserverIntersectionObserver con el umbral que establezcas. Todo se ejecuta una vez en DOMContentLoadedDOMContentLoaded.
De esa estructura se derivan cuatro consecuencias, y explican la mayoría de las preguntas que la gente plantea en el foro:
- Si renombras una clase, todo se rompe en silencio. Los nombres viven dentro del script que pegaste, no en tus elementos, así que Webflow no te avisará y el navegador no soltará ningún error.
- Los elementos que llegan tarde se quedan fuera. Los listeners se vinculan una sola vez; si algo aparece después (como la siguiente página de una lista de colecciones paginada), se queda sin reacción.
- El estado no se guarda. El cambio de clase vive en el DOM y en ningún otro sitio, así que el modo oscuro volverá a reiniciarse al navegar a otra página salvo que lo guardes por tu cuenta, un dilema que un hilo del foro documenta sin resolver.
- No se lleva bien con CMS Filter. El propio soporte de Finsweet aclaró que ambas librerías no nacieron para compartir fiesta en la misma página, tal como explican en este hilo.
Ninguno de estos son errores, sino más bien el costo de un generador que escribe código estático, y son la razón principal para preferir las interacciones nativas en una construcción nueva.
Desarrolla con la API de datos de Webflow
Los equipos que ejecutan Class Adder en muchos sitios pueden registrar y aplicar el script a través de los puntos finales de código personalizado de la API de datos en lugar de abrir cada sitio. Class Adder en sí no expone ninguna API, SDK, webhook o global invocable, por lo que el trabajo de la API recae totalmente en el lado de Webflow: estás desplegando un bloque de texto, no integrándote con un proveedor.
La ruta de despliegue utiliza los puntos finales de código personalizado. Vale la pena conocer dos grupos de puntos finales vecinos porque abarcan el mismo flujo de trabajo:
- Los endpoints de código personalizado registran un script en una web y lo aplican a todo el sitio o a una sola página.
- Los endpoints de elementos de colección se encargan del contenido del CMS sobre cuyas clases compartidas actuará el script más adelante.
- Los webhooks de Webflow envían un
site_publishevento que tu backend puede usar para confirmar que una implementación se realizó correctamente. - Los estilos y las clases en sí quedan fuera de alcance, ya que la API de datos no los gestiona. Estás implementando el comportamiento, no el CSS del que depende.
El acceso está restringido: los endpoints de código personalizado requieren un token de portador (bearer token) de una concesión de código OAuth con el custom_code:write ámbito, por lo que un token de sitio no servirá. Webflow indica que el desarrollo de aplicaciones está disponible en los planes Team y Enterprise.
Registra el script y aplícalo en todo el sitio
Cada llamada de implementación se dirige a la URL base https://api.webflow.com/v2, y el registro es un paso independiente de la aplicación.
Para implementar el script mediante programación:
- Registra el JavaScript generado como un script en línea con
POST /v2/sites/{site_id}/registered_scripts/inline. - Aplica el script registrado con
PUT /v2/sites/{site_id}/custom_code, o conPUT /v2/pages/{page_id}/custom_codepara el fragmento de iOS a nivel de página. - Consulta lo que está adjunto con
GET /v2/sites/{site_id}/custom_code. - Publica con .
POST /v2/sites/{site_id}/publish
Un sitio puede albergar un máximo de 800 scripts registrados, por lo que un bloque compartido de Class Adder por sitio está muy por debajo de ese límite. Los scripts en línea están limitados a 2000 caracteres, cifra a la que puede acercarse un bloque de modo oscuro con múltiples activadores, así que verifica la longitud antes de registrarlo.
Confirma la implementación con el webhook site_publish
La site_publish carga útil contiene siteId, publishedOn, domains, y publishedBy. Eso es suficiente para registrar qué sitio del cliente recibió la actualización y cuándo.
Para recibir el evento:
- Crea un webhook suscrito a
site_publishy asígnalo a tu endpoint. - Verifica cada
POSTusando los encabezadosx-webflow-timestampyx-webflow-signature; la firma es un HMAC SHA-256. - Compara
siteIden la carga útil con el sitio en el que realizaste la implementación y registra el resultado.
Si una entrega falla, se reintenta hasta tres veces más en intervalos de diez minutos. Después de eso, Webflow desactiva el webhook y te envía un correo electrónico, por lo que una canalización de implementación silenciosa podría dejar de informar sin que nadie se dé cuenta.
Lo que puedes construir con la integración de Finsweet Class Adder para Webflow
Cada patrón a continuación corresponde a un estado de estilo que ya has definido en Webflow, que es precisamente el objetivo de la herramienta:
- Reproductor de video fijo: Un activador de desplazamiento añade
.fixed-videoa.video-containercuando.video-triggersale del área de visualización, para que una demostración del producto siga al lector a lo largo de una página de destino extensa. - Modal con bloqueo de desplazamiento del cuerpo: Un clic en el activador del modal añade
.no-scrollabody. El fragmento de iOS a nivel de página cierra el espacio de Safari móvil para que la página detrás de un modal de registro permanezca fija. - Selector de modo oscuro: un solo botón añade y quita un puñado de clases en varios elementos entre el primer y segundo clic, regalándole a tu web de documentación un cambio de tema impecable sin duplicar páginas.
- Cambio de vista de lista a cuadrícula: Un clic añade o elimina
.grid-viewen varias clases de destino, de modo que un portafolio creado con una Lista de colección alterna entre una lista de texto y una cuadrícula de tarjetas.
Los cuatro casos no son más que alternancias de clases sobre estilos ya preparados en elementos estáticos o del CMS de Webflow. Si vas a desplegar esto en toda una flota de webs de clientes en vez de en una sola, échale un ojo a nuestra guía para aplicar código personalizado mediante la API de datos y conecta el servidor MCP de Webflow para que un agente audite qué sitios siguen usando este bloque.
Preguntas frecuentes
Para nada. Finsweet ya no incluye Class Adder en su catálogo actual y la web de demo lleva sin actualizarse desde diciembre de 2023. Si empiezas un proyecto desde cero, apuesta por las interacciones nativas de Webflow o pásate a Finsweet Attributes si buscas algo guiado por atributos. Guarda Class Adder solo en aquellas webs donde el script ya esté montado y funcionando como un reloj.
Qué va. Class Adder no está en el Marketplace, así que no hay nada que instalar: tú mismo pegas el script generado en el código personalizado. Finsweet tiene otras aplicaciones estupendas para Webflow, como Finsweet Components y la extensión de Finsweet, pero ninguna incluye los trucos de Class Adder.
No, y la razón es estructural, no una carencia en esos catálogos. Class Adder genera un bloque de JavaScript que se ejecuta en el navegador de tu página publicada. No tiene servicio alojado, ni API, ni cuenta, por lo que no hay nada con lo que una plataforma de automatización pueda autenticarse o interactuar. Zapier, Make y n8n pueden actuar sobre Webflow directamente, creando elementos de CMS o reaccionando a envíos de formularios, pero nada de eso afecta a Class Adder.
Sí, porque se dirige a clases CSS en lugar de a elementos individuales. Los elementos de la Lista de colección comparten las mismas clases, por lo que una regla generada se aplica a cada elemento de la lista. Se aplican dos limitaciones del foro de Finsweet: el estado basado en clases se restablece cuando un visitante pasa a otra página de una Lista de colección paginada, y el soporte de Finsweet ha indicado que Class Adder y CMS Filter no fueron diseñados para funcionar en la misma página. Ninguno de los hilos ofrece una solución.
Genera el código en el Visual Builder enlazado arriba y utiliza el sitio de demostración para ver seis ejemplos prácticos con un video explicativo para cada uno. También puedes clonar el proyecto clonable de Class Adder para inspeccionar una configuración terminada dentro de Webflow. Para preguntas que no cubran las demos, Finsweet remite a los usuarios al foro de Finsweet. Dos direcciones antiguas son callejones sin salida:
classadder.webflow.ioyclassadder-howto.webflow.ioson páginas en blanco que redirigen a nombres de host que ya no se resuelven, y el Visual Builder sigue enlazando la segunda.
Descripción
Añade y elimina clases CSS en elementos de Webflow al hacer clic, pasar el cursor, desplazarse o cargar la página. El Visual Builder de Finsweet genera un bloque de JavaScript independiente que pegas en el código personalizado del pie de página de tu sitio. Finsweet ya no incluye Class Adder entre sus productos actuales.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
Hacks de Finsweet para Webflow
Añade Finsweet Hacks a Webflow con código personalizado: mensajes de éxito en formularios con nombres, URLs de anclaje limpias, una calculadora de precios con casillas de verificación y cuándo usar Attributes.

Drupal
Conecta Drupal con Webflow para ofrecer contenido gestionado a través de un frontend visual mediante sincronización por API, herramientas de automatización o integraciones del lado del cliente.
Componentes de Finsweet
Conecta Finsweet Components, una aplicación nativa de Webflow, para añadir controles deslizantes, marquesinas, feeds de redes sociales, favoritos y pestañas automáticas con JavaScript directamente en el Diseñador de Webflow, sin necesidad de código personalizado.

EX.CO
Conecta EX.CO con Webflow para añadir reproductores de vídeo interactivos y monetizar tu contenido mediante códigos de inserción personalizados.

Pixie
Conecta Pixie con Webflow para automatizar la optimización de imágenes del CMS, reducir el tamaño de los archivos y acelerar los tiempos de carga de tus páginas.

One2 Menu
Añade un menú de restaurante de One2 Menu a una página de Webflow mediante un fragmento de código, para menús con código QR y cambios de precio que se publican al instante sin necesidad de volver a publicar la página.
Flowstar Tabs
Conecta Flowstar Tabs, un creador de pestañas sin código, con Webflow para organizar los detalles de tus productos, incluidas las especificaciones, en secciones de información personalizables con pestañas.
xAttribute

Typed.js
Conecta Typed.js, una biblioteca de animación de escritura en JavaScript, con Webflow para añadir titulares animados que rotan mediante elementos de inserción de código y cadenas gestionadas por el CMS.


