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.
Una Collection List muestra sus elementos en un orden fijo. Lo configuras en el panel de ajustes del elemento y cualquiera que entre tras publicar verá exactamente la misma secuencia. Si alguien quiere ver los precios de menor a mayor o prefiere leer primero las publicaciones más antiguas, no tiene cómo hacerlo. Finsweet List Sort da a los visitantes ese poder sin tener que rehacer la lista.
Una etiqueta de script en el código del encabezado del sitio y unos cuantos atributos personalizados convierten cualquier Webflow CMS Collection List en una lista que los visitantes pueden ordenar. Los usuarios reordenan los elementos mediante controles en la página. El ordenamiento ocurre en el navegador al reorganizar los elementos ya presentes, por lo que no se requiere ningún servidor ni llamada a API. El mismo fs-list-field atributo también gestiona List Filter, permitiendo que una lista filtrada se ordene sin necesidad de marcado adicional.
Los desarrolladores de agencias que crean directorios y bolsas de trabajo obtienen controles de ordenamiento mediante una configuración basada en atributos. El mismo sistema funciona para listados de propiedades. Los equipos de marketing internos pueden permitir que los lectores alternen un archivo de blog entre lo más nuevo y lo más antiguo. Los equipos de comercio electrónico añaden ordenamiento por precio y nombre a las páginas de catálogo de productos. Los fundadores que no programan pueden reemplazar una lista estática de socios en PDF por un directorio CMS dinámico que se ordena de la A a la Z.
Cómo integrar Finsweet List Sort con Webflow
¿Qué es Finsweet List Sort? Finsweet List Sort es una solución de JavaScript del lado del cliente dentro de la biblioteca Finsweet Attributes, publicada bajo la licencia Apache 2.0. Clasifica el contenido en un CMS o lista estática reordenando los elementos DOM que la página ya ha renderizado. La versión actual es Attributes V2, que reemplazó la solución heredada CMS Sort y sus fs-cmssort-* atributos con el fs-list-* espacio de nombres.

Los equipos recurren a List Sort cuando una Collection List tiene más elementos de los que a cualquiera le apetecería revisar en el orden por defecto. Por ejemplo, quien creó el directorio MyGreen.dk reunió más de 300 consejos en Webflow y aprovechó Finsweet Attributes para filtrado, búsqueda libre y ordenación. La base de datos de vehículos Toyota en Made in Webflow permite reorganizar los modelos del mismo modo, aunque su código publicado todavía utiliza los scripts clásicos CMS Sort, CMS Load y CMS Filter de Finsweet en vez de las soluciones List actuales.
La integración de Finsweet List Sort con Webflow admite dos enfoques:
- El código personalizado en las etiquetas head y body, junto con atributos personalizados, se encargan de toda la experiencia de ordenación para el visitante mediante ajustes visuales.
- La API de datos de Webflow y la API de Finsweet Attributes te dan el control sobre los criterios de ordenación y el estado inicial, aunque la parte de la API de datos requiere desarrollo en el servidor.
La mayoría de las implementaciones utilizan únicamente el método de atributos y añaden la ruta de la API para un ordenamiento predeterminado al cargar o para actualizaciones automáticas de las claves de ordenamiento.
Añade el script de Attributes y aplica los atributos fs-list
Este método abarca todas las funciones documentadas de List Sort y no requiere más JavaScript que la etiqueta de script de Finsweet. Es perfecto para diseñadores y desarrolladores que crean Collection Lists en Webflow y quieren dar al visitante el control para ordenar en el sitio publicado. Necesitas acceso al código en head y body, disponible con un plan de Workspace Core, Growth, Agency o Freelancer, o con un plan de sitio activo. Finsweet indica dónde colocar la etiqueta de script y la documentación de List Sort detalla cada atributo. Acuérdate de publicar el sitio antes de probar.
Para configurar la integración:
- Ve a Site settings > Custom code > Head code y pega la etiqueta del script V2, tal como indica Finsweet. Si solo lo quieres para una página concreta, usa Page settings > Custom code > Inside <head> tag.
<script async type="module"
src="https://cdn.jsdelivr.net/npm/@finsweet/attributes@2/attributes.js"
fs-list></script>
- Abre el panel Add, entra en Elements > CMS, arrastra una Collection List a la página y vincula su Source a una CMS Collection.
- Selecciona la Collection List, abre el panel de configuración del elemento y, en Atributos personalizados, haz clic en el icono más. Añade
fs-list-elementcon el valorlist. El artículo sobre atributos personalizados te guía por el panel. - Selecciona el elemento de texto dentro del Collection Item que contiene el valor de ordenamiento. Añade
fs-list-fieldcon un identificador comoname,dateoprice. Repite esto para cada campo ordenable. Asigna un identificador diferente a cada campo. - Añade uno de los controles de activación descritos a continuación y asígnale
fs-list-elementcon el valorsort-trigger. - Establece la dirección del ordenamiento. Las opciones de selección y desplegables utilizan valores como
name-ascyname-desc, mientras que los botones alternan la dirección automáticamente. - Publica el sitio y prueba la ordenación en la URL en vivo.
Más allá de los atributos obligatorios, estos atributos opcionales funcionan sin necesidad de JavaScript adicional:
fs-list-fieldtype="date"o cambia un campo de alfanumérico a comparación numérica o de fecha.fs-list-fieldtype="number"fs-list-reverse="true"se coloca en el elemento y hace que el primer clic en un botón ordene de forma descendente en lugar de ascendente.fs-list-element="list"fs-list-ascclassy en el activador de ordenación cambian el nombre de las clases de estado activo predeterminadas y .fs-list-descclassis-list-ascis-list-descfs-list-element="scroll-anchor"en un bloque div desplaza la página hasta ese elemento después de cada ordenación.fs-list-element="dropdown-label"en un bloque de texto dentro de un menú desplegable se actualiza para mostrar la opción de ordenación activa.fs-list-instance="IDENTIFIER"en un contenedor principal común ejecuta instancias independientes de List Sort en una misma página.fs-list-durationen el elemento de lista establece el tiempo de animación en milisegundos, mientras que en el contenedor de la lista de colección cambia el nombre de la clase aplicada durante la ordenación.fs-list-sortingclass.is-list-sorting- Las listas estáticas también se pueden ordenar si replicas la estructura de la lista de colección con bloques div.
Incluye la etiqueta de script una vez por página, incluso si combinas List Sort con List Filter o List Load. Una actualización de agosto de 2026 también te permite pegar una cadena completa en el campo de atributo, y esta se divide automáticamente en nombre y valor.name=value
Ordenar con un activador de campo de selección
Un catálogo de cursos con opciones de precio y nombre puede agrupar todas las elecciones en un solo control. Cada opción del campo de selección representa un campo y una dirección, lo que resulta ideal para listas con varios campos de ordenación. Su valor combina el identificador del campo con o .-asc-desc
Para configurar un activador de campo de selección:
- Añade un bloque de formulario cerca de la lista de colección y coloca un campo de selección dentro.
- Añade con el valor al campo de selección.
fs-list-elementsort-trigger - Añade una opción para cada criterio de ordenación y establece su valor en o , por ejemplo y .
IDENTIFIER-ascIDENTIFIER-descname-ascdate-desc
El identificador de cada valor debe coincidir con un en un elemento dentro del ítem de colección.fs-list-field
Ordenar con activadores de botón
El primer clic ordena de forma ascendente y el segundo de forma descendente. Los botones, enlaces de texto y bloques de enlace funcionan como interruptores para un solo campo. Esto es perfecto para encabezados tipo tabla donde cada columna se ordena por sí misma, como una columna de precios en una cuadrícula de productos.
Para configurar un activador de botón:
- Añade un botón, un enlace de texto o un bloque de enlace.
- Añade
fs-list-element="sort-trigger"yfs-list-field="price"al botón con el mismo identificador que el elemento del campo. - Añade
fs-list-reverse="true"a la lista de colección, no al botón, si quieres que el primer clic ordene de forma descendente. - Aplica estilos a las clases combinadas
is-list-ascyis-list-descpara que los visitantes puedan ver la dirección activa.
Añade un botón independiente para cada campo que quieras mostrar; cada uno funciona por su cuenta.
Ordenar con un activador de menú desplegable
Para tener control total sobre el diseño, coloca las opciones de ordenación dentro de un menú desplegable. Los enlaces llevan el campo y la dirección, y el contenido del menú puede ser estático o provenir del CMS.
Para configurar un activador de menú desplegable:
- Añade un elemento desplegable y asígnale
fs-list-element="sort-trigger". - Dentro del menú desplegable, añade un enlace para cada opción con
fs-list-field="name-asc",fs-list-field="name-desc", etcétera. - Añade un bloque de texto dentro del activador desplegable con
fs-list-element="dropdown-label"si quieres que el activador refleje la elección actual.
El texto de la etiqueta se actualiza con la opción activa, así los visitantes ven el orden actual sin tener que abrir el menú.
Ordenar por fecha o número
La ordenación de listas trata cada valor como una cadena de texto de forma predeterminada, por lo que las fechas y los números no se ordenan correctamente hasta que defines el tipo de campo. Un atributo en el elemento del campo cambia la comparación. El valor en el texto renderizado debe coincidir con un formato compatible.
Para ordenar por fecha o número:
- Selecciona el elemento que contiene
fs-list-fieldy añadefs-list-fieldtypecon el valordateonumber. - Para las fechas, utiliza uno de los formatos compatibles:
July 4, 2021,July 4, 2021 13:30,07/04/2021,07/04/2021 13:30, oDecember 2021. - Para los números, utiliza un valor simple como
25.89,-13, o100.50. Se admiten decimales y números negativos.
Un campo de moneda como $1,234.56 contiene caracteres no numéricos y se ordena incorrectamente, así que vincula un campo numérico oculto y aplica fs-list-fieldtype="number" a ese elemento en su lugar.
Ordena más de 100 elementos con List Load
Una Collection List muestra hasta 100 elementos sin paginación, según los límites de contenido dinámico, y List Sort solo reorganiza los elementos que ya están en el DOM. Con la paginación nativa sin más, cada página se genera por separado, así que el orden solo afecta a esa página. List Load carga más elementos en el navegador para que la ordenación los incluya a todos.
Para ordenar una colección más grande:
- En Element settings > Collection list settings, activa Paginate items. Finsweet marca la paginación nativa como un paso obligatorio para usar List Load.
- Añade
fs-list-loadal mismofs-list-element="list"elemento con el modoall,more,infinite, opagination. - Publica y confirma que el orden incluye los elementos cargados.
Solo el modo all renderiza la colección completa; los otros modos ordenan lo que se haya cargado hasta el momento. Finsweet recomienda el modo Paginación en lugar de Renderizar todo para un mejor rendimiento, especialmente junto con List Filter, y advierte que cargar miles de elementos a la vez afecta el rendimiento en conexiones móviles.
Construye con la API de datos de Webflow y la API de Attributes de Finsweet
La API de atributos es JavaScript de navegador expuesto en window.FinsweetAttributes, por lo que se ejecuta dentro de la página renderizada y no en un servidor. La API de atributos te permite establecer un orden predeterminado, conectarte al ciclo de vida de la lista y leer el estado sorting reactivo de una instancia de lista. La API de datos de Webflow se ejecuta en el lado del servidor y escribe los valores de los campos CMS que List Sort lee una vez que la página se renderiza. Usa esta ruta cuando necesites un orden predeterminado al cargar, un orden después de que List Load se renderice o actualizaciones automáticas para una clave de orden numérica. El lado de la API de datos requiere desarrollo en el lado del servidor.
Documentación de referencia para la integración:
- La API de atributos general documenta
process,modules, yutilsenwindow.FinsweetAttributes, además de sus métodospush,load, ydestroy. - La API de datos de Webflow lista las colecciones y los elementos que contienen, que es donde se encuentra el campo para ordenar.
- El endpoint de actualización masiva tiene un tope de 100 elementos por petición, lo que marca el límite para guardar claves de ordenación de una sola vez.
- Los webhooks de Webflow envían eventos de
collection_item_created,collection_item_changed, ysite_publisha tu punto de conexión como solicitudes JSONPOST.
Las dos capas comparten los valores de los campos a través del HTML publicado y funcionan de forma independiente.
Establece un orden predeterminado al cargar la página
Una vez que el módulo list se inicializa, una breve devolución de llamada puede establecer el orden a través de un elemento activador oculto en la página. El activador oculto puede ser un bloque de enlace con los atributos aplicados, o un fragmento HTML dentro de un elemento Code Embed. La devolución de llamada se ejecuta una vez que el módulo list se ha inicializado y te entrega cada instancia de lista activa.
Para ordenar una lista al cargar:
- Añade un activador oculto dentro de un bloque Div configurado en
display: none, ya sea como un Code Embed o como un bloque de enlace que contenga los mismos atributos:
<div style="display: none">
<a fs-list-element="sort-trigger" fs-list-field="date" fs-list-fieldtype="date">Date trigger</a>
</div>
- En la misma sección de código personalizado, después de la etiqueta de script de Attributes, registra una devolución de llamada y establece el estado de orden:
window.FinsweetAttributes ||= [];
window.FinsweetAttributes.push(['list', (listInstances) => {
const [listInstance] = listInstances;
listInstance.sorting.value.fieldKey = 'date';
listInstance.sorting.value.direction = 'desc';
}]);
- Publica y confirma que la lista carga primero los elementos más recientes.
El sorting objeto es reactivo y contiene fieldKey, direction (asc o desc), y interacted, por lo que los cambios posteriores en esas propiedades reordenan la lista. El soporte de Finsweet documenta este patrón en un hilo del foro sobre List Combine.
Aplica una ordenación predeterminada después de que List Load realice el renderizado
Los elementos añadidos por List Load o List Combine siguen el mismo orden de clasificación a través del afterRender hook. El README del paquete list enumera las claves del ciclo de vida en orden: start, filter, sort, static, pagination, beforeRender, render, afterRender. Cada callback del hook recibe la matriz de elementos de la fase anterior y puede devolver una matriz modificada o una Promesa.
Para ordenar después del renderizado:
- Registra el callback y adjunta el hook en la misma sección de código personalizado:
window.FinsweetAttributes ||= [];
window.FinsweetAttributes.push(['list', (listInstances) => {
const [listInstance] = listInstances;
listInstance.addHook('afterRender', (items) => {
listInstance.sorting.value.fieldKey = 'date';
listInstance.sorting.value.direction = 'desc';
});
}]);
- Mantén el elemento disparador oculto del sub-método anterior en la página.
- Publica y carga más elementos para confirmar que el orden se mantiene.
El soporte de Finsweet compartió este enfoque exacto en un hilo sobre ordenación predeterminada. Usa listInstance.effect(callback) para ejecutar código cada vez que cambie el estado reactivo, y listInstance.triggerHook(key) para activar una fase manualmente.
Actualiza las claves de ordenación con la API de datos y webhooks
Un rango, puntuación o precio de un sistema externo debe escribirse en un campo de CMS de tipo Número o Texto sin formato a través de la API de datos, y luego publicarse para que el valor aparezca en el HTML renderizado. List Sort detecta los nuevos valores en la siguiente carga de página sin necesidad de cambios en el lado del cliente.
Para automatizar las actualizaciones de las claves de ordenación:
- Actualiza campos de forma masiva con
PATCH /v2/collections/{collection_id}/items. - Publica los cambios con
POST /v2/collections/{collection_id}/items/publish, o crea y publica en un solo paso conPOST /v2/collections/{collection_id}/items/live. - Suscríbete a
collection_item_changedconPOST /v2/sites/{site_id}/webhookspara que tu servicio recalcule los valores de ordenación derivados cuando los editores modifiquen elementos.
Cada una de esas llamadas se ejecuta contra la misma colección que la página ya ordena, por lo que no cambia nada en el front-end. Aplica fs-list-fieldtype="number" al elemento vinculado al nuevo campo para que se ordene numéricamente.
Lo que puedes construir con la integración de Finsweet List Sort para Webflow
Integrar Finsweet List Sort con Webflow ofrece a los visitantes control sobre el orden de la lista mediante controles basados en atributos y evita tener que reconstruir todo en un framework de frontend.
- Catálogo de productos ordenable por precio: Vincula un campo de precio simple con
fs-list-fieldtype="number"y añade un disparador de botón confs-list-field="price"sobre una cuadrícula de productos. Los compradores alternan entre precio ascendente y descendente con un solo clic, y Finsweet confirma que los Atributos funcionan en páginas de catálogo de Webflow Ecommerce. - Directorio alfabético con cientos de entradas: Combina List Sort con List Load y List Filter en un campo
name. El Directorio de Herramientas Offboard utiliza Webflow CMS con Atributos de Finsweet para filtrar, ordenar y buscar en sus listados de herramientas. - Archivo de blog o recursos ordenado por fecha: Aplica
fs-list-fieldtype="date"a la fecha de publicación y ofrecedate-descydate-ascen un campo de selección. Los lectores pueden ver la publicación más reciente o avanzar desde la más antigua, y un disparador oculto establece el orden de más reciente a más antiguo por defecto. - Base de datos de vehículos o especificaciones con múltiples campos: muestra varios
fs-list-fieldidentificadores en cada elemento de la colección para que los visitantes puedan ordenar por modelo, año o precio. El ejemplo de Toyota anterior combina la ordenación con un control deslizante de rango sobre el framework Client-First.
Cada uno de estos comienza con los mismos dos elementos: una lista de colección que contiene fs-list-element="list" y un activador al que el visitante puede acceder. Una vez que la lista se ordena sola, el resto del trabajo consiste en mantener actualizada la colección subyacente, así que lee cómo automatizar los listados de ofertas de empleo y deja que el CMS rellene la lista que acabas de hacer ordenable.
Preguntas frecuentes
List Sort utiliza la etiqueta de script de Attributes y atributos personalizados. No hace falta ninguna aplicación del Marketplace. La extensión de Finsweet está en el Marketplace, pero sus funciones documentadas son herramientas de flujo de trabajo como Asset Exporter, Dev Mode, Merge Combo Classes y Migrate PX to REM, ninguna de las cuales añade ordenación a un sitio publicado. La ordenación proviene de la etiqueta de script más
fs-list-*atributos en la lista de colección, sus elementos de campo y el activador.Los atributos funcionan exclusivamente en sitios publicados y en vivo. El modo de vista previa los deja inactivos. Finsweet indica en Cómo funciona Finsweet Attributes que las soluciones aún no funcionan en el modo de vista previa. Publica el sitio y prueba el activador en la URL en vivo, o en el
webflow.iodominio de pruebas, después de cada cambio.Sí, con un añadido. Una lista de colección muestra como máximo 100 elementos a menos que la paginación esté activada, y List Sort solo reordena los elementos que ya están en la página, por lo que con la paginación nativa cada página se ordena por su cuenta. Añadir la solución List Load de Finsweet permite cargar los elementos restantes en la misma lista primero, y la ordenación cubrirá entonces todo lo que se haya cargado.
A List Sort en sí, no. Attributes es una librería para el navegador y no ofrece ningún endpoint en el servidor al que pueda llamar una plataforma de automatización. Eso sí, esas plataformas se integran con Webflow, y las plantillas de Zapier para Webflow incluyen una para crear elementos del CMS. Puedes guardar así el valor por el que quieras ordenar en un campo de texto o numérico del CMS y dejar que List Sort ordene la lista a partir de ahí en cuanto cargue la página.
Reemplaza cada
fs-cmssort-*atributo por su equivalentefs-list-*enattributes.jsV2, luego cambia los scripts de la V1 por el único script de la V2 y elimina el código de la V1 de la página. Finsweet describe las dos versiones como incompatibles en una misma página y recomienda pasar a la V2. Los cambios clave sonfs-cmssort-element="list"afs-list-element="list",fs-cmssort-fieldafs-list-field,fs-cmssort-element="trigger"afs-list-element="sort-trigger", yfs-cmssort-typeafs-list-fieldtype. Revisa los elementos de código incrustado en busca de atributos V1 residuales, que el soporte de Finsweet pidió a un usuario que limpiara en un hilo de ordenación de 2026.
Descripción
Añade ordenamiento controlado por el usuario a las Collection Lists de Webflow mediante una etiqueta de script de Attributes y atributos personalizados fs-list. Clasifica los campos compatibles con controles orientados al visitante.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
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.

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!


