MixItUp
Conecta MixItUp con Webflow para añadir filtrado, ordenación y transiciones de diseño animadas a contenido estático y gestionado por CMS.
MixItUp transforma cuadrículas planas y colecciones CMS en diseños interactivos y filtrables con filtros animados en el DOM, ordenación y transiciones CSS de lo más fluidas. Los elementos aparecen, cambian de tamaño y se recolocan con gracia en cuanto el visitante hace clic en un filtro o control, funcionando a las mil maravillas tanto con contenido estático como con colecciones de Webflow CMS.
El filtrado de colecciones nativo cubre la selección básica de categorías en colecciones de menos de 100 elementos, pero no gestiona transiciones animadas ni ordenación por múltiples criterios en una misma página. Utiliza MixItUp en sitios de portafolios, cuadrículas de productos, bibliotecas de recursos y directorios de equipos cuando busques transiciones de categoría animadas o filtrado multidimensional y te sientas cómodo con JavaScript.
Cómo integrar MixItUp con Webflow
¿Qué es MixItUp? MixItUp es una librería de JavaScript sin dependencias pensada para filtrar, ordenar y manipular el diseño en el DOM con animaciones bien vistosas. Se ejecuta por completo en el navegador, usando selectores de clase CSS y atributos de datos personalizados para mostrar, ocultar y reordenar elementos con efectos de animación configurables. MixItUp y sus extensiones (MultiFilter, Pagination) son de código abierto bajo la licencia Apache 2.0.

Combina MixItUp con Webflow cuando necesites cambios de estado animados en cuadrículas de contenido, criterios de filtro combinados entre taxonomías u órdenes de clasificación personalizados que vayan más allá del filtrado de colecciones nativo. La biblioteca es estable y está ampliamente implementada, aunque el repositorio se archivó en octubre de 2024, por lo que no debes esperar futuras actualizaciones ni correcciones de errores.
Normalmente elegirás entre dos patrones de implementación:
- La inserción de código personalizado te permite añadir MixItUp a cualquier página para filtrar y ordenar contenido estático o gestionado por CMS sin necesidad de una aplicación del marketplace.
- La API de datos de Webflow junto con la API de conjuntos de datos de MixItUp es una arquitectura personalizada para colecciones que superan los 100 elementos, pero requiere desarrollo del lado del servidor.
Empieza con código personalizado y pasa a la opción de la API solo cuando el tamaño de la colección o la arquitectura lo requieran.
Casi todo el mundo tira de código personalizado. Resérvate el camino de la API solo si tu colección supera el límite de 100 elementos de las listas de colecciones.
Añadir MixItUp con código personalizado
Para integrar MixItUp, añade el script CDN y el código de inicialización en los campos de código personalizado de tu página. Esta fórmula funciona de lujo tanto para contenido estático, donde asignas las clases de categoría a mano, como para colecciones del CMS, donde JavaScript genera las clases de filtrado al vuelo. Necesitas un plan de sitio de pago para publicar código personalizado. Los efectos de MixItUp no se aprecian en la vista previa del lienzo, así que publica o pasa el sitio a staging para ponerlos a prueba.
Carga primero la biblioteca y crea la estructura HTML necesaria.
Configurar el filtrado en contenido estático
Asigna clases de categoría directamente a los elementos, añade botones de filtro con atributos personalizados e inicializa MixItUp con un pequeño script.
Para configurar el filtrado estático:
- Abre la configuración de la página de destino, desplázate hasta Código personalizado y pega el script CDN de MixItUp en el campo Antes de la etiqueta
</body>:
<script src="https://cdn.jsdelivr.net/npm/mixitup@3/dist/mixitup.min.js"></script>
- Crea un div contenedor y asígnale una clase (por ejemplo,
container). Dentro de ese div, añade tus elementos de contenido y dale a cada uno la clasemixmás una o varias clases de categoría comopeopleoplaces. Los elementos que pertenecen a varias categorías reciben múltiples clases (por ejemplo,mix people places). - Añade botones de filtro fuera del contenedor. Selecciona cada botón, abre la configuración del elemento (Element Settings) y añade un atributo personalizado con el nombre
data-filter. Establece el valor enallpara el botón "mostrar todo", o en un selector de clase con prefijo de punto, como.peoplepara los botones de categoría. El prefijo de punto es obligatorio para los selectores basados en clases. - Para los botones de ordenación, añade un atributo personalizado llamado
data-sortcon valores comoorder:asc,order:desc,random, odefault. Añade los atributosdata-ordercorrespondientes a cada elemento.mixa través de la configuración del elemento con valores numéricos. - Debajo de la etiqueta de script CDN en el mismo campo de etiqueta Before
</body>tag, añade el código de inicialización:
<script>
var containerEl = document.querySelector('.container');
var mixer = mixitup(containerEl);
</script>
- Publica el sitio y pruébalo en la URL en vivo.
Ya tienes una configuración básica de filtrado y ordenación que puedes personalizar y ampliar.
MixItUp añade automáticamente la clase mixitup-control-active al botón de filtro que esté seleccionado en ese momento. Añádela como una clase combinada para darle estilo al estado activo con un color de fondo o un formato de texto diferente.
Configura el filtrado en contenido CMS
Los elementos del CMS no reciben automáticamente clases CSS basadas en categorías, así que añade una función de JavaScript que lea los valores de los campos ocultos del CMS de cada elemento de la colección y los convierta en nombres de clase válidos durante la ejecución.
Para configurar el filtrado del CMS:
- En tu colección CMS, añade un campo de referencia o de opción para las categorías. Ni se te ocurra usar uno de multirreferencia, ya que es incompatible con este método.
- Añade una lista de colección (Collection List) a tu página. Asigna una clase al elemento de la lista de colección (por ejemplo,
posts-collection-list), y luego asigna la clasemixa cada elemento de la colección (Collection Item). - Dentro de cada elemento de la colección, añade un elemento de texto y vincúlalo al campo de categoría del CMS. Dale a este elemento de texto una clase como
filtering-categories. Configúralo endisplay: nonepara que esté oculto a los visitantes. - Para la ordenación, añade otro elemento de texto oculto vinculado al campo de ordenación (como una fecha o un campo numérico) con una clase como
sorting-categories. - Añade botones de filtro con atributos personalizados
data-filter, igual que en la configuración estática. Los valoresdata-filterdeben coincidir con los nombres de las clases CSS que generará el script de conversión. Para una categoría de CMS llamada "Web Design", la clase generada esweb-design, por lo que el botón necesitadata-filter=".web-design". - En la configuración de la página (Page Settings), bajo el código personalizado (Custom Code), pega el script de inicialización completo en el campo de etiqueta Before
</body>tag:
<script src="https://cdn.jsdelivr.net/npm/mixitup@3/dist/mixitup.min.js"></script>
<script>
// Convert CMS text to valid CSS class names
var conv = function (str) {
if (!str) { str = 'empty'; }
return str.replace(/[!\"#$%&'\(\)\\+,\.\/\:;<=>?\@[\]\^`\{\|\}~]/g, '')
.replace(/ /g, "-")
.toLowerCase()
.trim();
};
// Add filter classes from CMS category fields
var catArray = document.querySelectorAll('.filtering-categories');
catArray.forEach(function(elem) {
var text = elem.innerText || elem.innerContent;
var className = conv(text);
elem.parentElement.parentElement.classList.add(className);
});
// Add sort attributes from CMS fields
var sortArray = document.querySelectorAll('.sorting-categories');
sortArray.forEach(function(sortElem) {
var sortText = sortElem.innerText || sortElem.innerContent;
sortElem.parentElement.parentElement.setAttribute('data-order', sortText);
});
// Initialize MixItUp
var containerEl = document.querySelector('.posts-collection-list');
mixitup(containerEl);
</script>
El script convierte los valores del CMS en nombres de clase e inicializa el filtrado en una sola pasada.
La función conv() elimina los caracteres especiales, sustituye los espacios por guiones y convierte la cadena a minúsculas. Necesitas este paso de conversión porque los valores de los campos del CMS suelen contener espacios y caracteres que no son válidos en los selectores CSS.
La cadena .parentElement.parentElement recorre desde el elemento de texto oculto hasta el elemento de colección .mix. Si la estructura de tu elemento anida el elemento de texto a una profundidad diferente, ajusta el número de llamadas a .parentElement para que coincida. Una profundidad de recorrido incorrecta es una de las causas más comunes de fallos silenciosos en el filtrado.
Añade extensiones para filtrado multidimensional y paginación
La extensión MultiFilter de MixItUp permite aplicar filtros simultáneos entre grupos independientes (por ejemplo, filtrar por color y talla a la vez sin despeinarse). Por su parte, la extensión Pagination añade una navegación por páginas directamente en el navegador dentro del conjunto filtrado.
Para usar las extensiones:
- Carga cada script de extensión después del script principal de MixItUp y antes de la inicialización:
<script src="https://cdn.jsdelivr.net/npm/mixitup@3/dist/mixitup.min.js"></script>
<script src="path-to-mixitup-multifilter.min.js"></script>
<script src="path-to-mixitup-pagination.min.js"></script>
- Registra las extensiones y pasa las opciones de configuración durante la inicialización:
mixitup.use(mixitupMultifilter);
mixitup.use(mixitupPagination);
var mixer = mixitup(containerEl, {
multifilter: { enable: true },
pagination: { limit: 12 },
animation: {
effects: 'fade scale(0.5)',
duration: 300
}
});
Carga las extensiones después del script principal de MixItUp. Cargarlas primero produce el error . La paginación solo funciona en elementos ya renderizados en el DOM, por lo que sigue limitada por el límite de renderizado de 100 elementos de la Lista de Colección. Desactiva la paginación nativa en cualquier Lista de Colección donde la paginación de MixItUp esté activa.[MixItUp Pagination] MixItUp core not found
Usa un Code Embed para scripts en línea
También puedes plantar el código de inicialización de MixItUp directamente en el diseño de tu página con un elemento Code Embed. Abre el panel Añadir, baja hasta la sección Avanzado y arrastra un Code Embed a tu página. Este truco viene de perlas si quieres colocar el script en un punto exacto del DOM o si necesitas vincular valores de campos del CMS directamente en el código usando el puntito morado de vinculación en el editor.
Cada elemento Code Embed tiene un límite de 50,000 caracteres. Si tu script supera este límite, alójalo externamente y haz referencia a él mediante una etiqueta , o divídelo en varios elementos Code Embed.<script src="">
Construye con la API de datos de Webflow y la API de conjuntos de datos de MixItUp
Para colecciones que superan los 100 elementos, el enfoque estándar de Lista de Colección deja de funcionar porque una Lista de Colección renderiza un máximo de 100 elementos. Combinar la API de datos de Webflow con la API de conjuntos de datos de MixItUp te ofrece una arquitectura personalizada para superar este límite. Este no es un modo de integración integrado o sin código; requiere desarrollo del lado del servidor, incluida la implementación de OAuth y middleware para la obtención de datos.
- La API de datos de Webflow obtiene elementos de la colección del CMS a través de , devolviendo JSON estructurado con metadatos de paginación
GET /v2/sites/{site_id}/collections/{collection_id}/items - Los Webhooks activan eventos como y para mantener tus datos sincronizados
collection_item_createdcollection_item_changed - La API Dataset de MixItUp se zampa un array de modelos de datos y renderiza o filtra elementos sin depender de elementos preexistentes en el DOM
Juntas, estas API admiten una canalización de filtrado de servidor a cliente para colecciones grandes.
Obtén y renderiza elementos del CMS con la API de conjuntos de datos
Tu servidor gestiona la autenticación y la paginación de la API, y luego pasa el conjunto de datos completo al navegador para que MixItUp lo administre.
Para implementarlo:
- Configura un punto final del lado del servidor que se autentique con un token Bearer (alcance: ) y obtenga elementos de . Gestiona la paginación de la API para recuperar todos los elementos más allá de la primera página de resultados.
cms:readGET /v2/sites/{site_id}/collections/{collection_id}/items - Transforma la respuesta de la API en una matriz plana de objetos. Cada objeto necesita una propiedad única y cualquier campo de categoría o clasificación que requieran tus filtros.
id - En el lado del cliente, pasa la matriz a la API de conjuntos de datos de MixItUp durante la inicialización:
var mixer = mixitup(containerEl, {
data: { uidKey: 'id' },
load: { dataset: fetchedItems }
});
- Llama a o para actualizar la visualización según sea necesario.
mixer.filter('.category-name')mixer.dataset(updatedItems)
Este enfoque elimina por completo el límite de 100 elementos, pero añade complejidad en la gestión de tokens OAuth, alojamiento del servidor y sincronización de datos. Suscríbete a los eventos de webhook y para mantener el conjunto de datos actualizado sin actualizaciones manuales.collection_item_changedcollection_item_created
¿Qué puedes construir con la integración de MixItUp en Webflow?
Combinar MixItUp con Webflow te permite convertir cuadrículas estáticas y colecciones CMS en diseños interactivos y filtrables sin tener que reconstruir las páginas para cada categoría de contenido.
- Cuadrícula de portafolio animada: Monta el portafolio de una agencia de diseño donde los visitantes filtren proyectos por categoría (branding, web o print) con suaves transiciones de desvanecimiento y escala. Cada tarjeta de proyecto lleva clases combinadas que MixItUp lee al instante para filtrar con animaciones en una sola página.
- Archivo de blog CMS con clasificación por categoría y fecha: Crea una página de listado de blog donde los lectores filtren las publicaciones por tema y las ordenen por fecha de publicación, todo desde una única lista de colección. La
conv()función genera clases de filtro a partir de los campos de categoría del CMS, y losdata-sortatributos gestionan el orden cronológico. - Catálogo de productos multidimensional: Crea una tienda online donde los clientes filtren por varios criterios a la vez (como color, talla y rango de precio) gracias a la extensión MultiFilter. Cada grupo de filtros va por libre, afinando los resultados sin recargar la página en ningún momento.
- Biblioteca de recursos paginada: Diseña una base de conocimiento o biblioteca de documentos con la extensión Pagination para mostrar 12 elementos por página sin perder los filtros por categoría ni la ordenación. La extensión se encarga de que pases de página dentro del grupo filtrado sin despeinarse.
Si necesitas un mayor control sobre colecciones que superen los 100 elementos o requieres la obtención de datos desde el servidor, la ruta de integración mediante API cubre esos casos con total flexibilidad.
Preguntas frecuentes
Para nada. MixItUp y todas sus extensiones son totalmente gratuitas bajo la licencia Apache 2.0. Cualquier tutorial o artículo que diga que hace falta una licencia comercial se quedó en el pasado. Puedes usar MixItUp en proyectos para clientes sin soltar un solo céntimo.
El código personalizado no se ejecuta en el lienzo de Webflow. Debes publicar tu sitio en una URL de prueba o de producción para ver los efectos de filtrado y ordenación de MixItUp. Este es el comportamiento esperado para cualquier biblioteca de JavaScript cargada mediante campos de código personalizado.
No con una configuración estándar de lista de colección. Webflow renderiza un máximo de 100 elementos por lista de colección, y MixItUp solo puede operar sobre los elementos presentes en el DOM. Existen dos soluciones: usar varias listas de colección combinadas mediante llamadas de JavaScript
.append()antes de la inicialización, o usar la API de datos de Webflow con la API de conjuntos de datos de MixItUp para un enfoque totalmente gestionado por el servidor. El plan CMS admite hasta 2000 elementos y el plan Business hasta 10 000, pero recuperarlos todos requiere llamadas a la API en lugar de renderizado de listas de colección.Usa flexbox o inline-block en los contenedores de MixItUp. CSS Grid se lleva a matar con los cálculos de posición de MixItUp y hace que los elementos se solapen tras filtrar. La librería anima posiciones absolutas durante las transiciones, lo que choca de frente con el modelo de CSS Grid. Pon tu lista de colección o div contenedor en flexbox con wrap y verás cómo los elementos vuelven a su sitio como la seda tras cada filtrado.
El repositorio de MixItUp se archivó el 30 de octubre de 2024 y ha quedado en modo de solo lectura para siempre. Ya no habrá correcciones de errores ni funciones nuevas. La librería sigue siendo una roca y funciona en decenas de miles de sitios, pero los problemas abiertos que ya existen se quedan como están.
Para proyectos que pidan mantenimiento activo o una configuración sin tocar código, Finsweet Attributes (gratuito, basado en atributos) y Jetboost (de pago, con configuración guiada) son alternativas en pleno desarrollo. Aun así, MixItUp sigue siendo un as en la manga si buscas transiciones animadas muy vistosas y cuentas con manos expertas en desarrollo.
Descripción
Añade filtrado, ordenación y paginación animados a las páginas y colecciones CMS de Webflow integrando MixItUp mediante código personalizado y la API de datos de Webflow.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
Finsweet-List-Sort
Conecta Finsweet List Sort con Webflow para que los visitantes puedan reordenar los elementos de una Collection List por texto, fecha o número directamente en el navegador.

Haze: búsqueda rápida para Webflow
Búsqueda rápida para ecommerce

Biblioteca CMS: Ordenar
¡Ordena los elementos de una lista de colección según el contenido de texto dentro del elemento con la biblioteca CMS de Finsweet!

Biblioteca CMS: Filtro
¡Filtra elementos en una lista de colección según el contenido de texto dentro del elemento con la biblioteca CMS de Finsweet!


