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.

→
↗
►
↓
←
↑
Instalar aplicación
→
↗
►
↓
←
↑
Ver sitio web
→
↗
►
↓
←
↑
Ver lección
→
↗
►
↓
←
↑
Configuración de registros A
→
↗
►
↓
←
↑
Configuración de registros CNAME
Finsweet-List-Sort

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:

  1. 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>
  1. Abre el panel Add, entra en Elements > CMS, arrastra una Collection List a la página y vincula su Source a una CMS Collection.
  2. 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-element con el valor list. El artículo sobre atributos personalizados te guía por el panel.
  3. Selecciona el elemento de texto dentro del Collection Item que contiene el valor de ordenamiento. Añade fs-list-field con un identificador como name, date o price. Repite esto para cada campo ordenable. Asigna un identificador diferente a cada campo.
  4. Añade uno de los controles de activación descritos a continuación y asígnale fs-list-element con el valor sort-trigger.
  5. Establece la dirección del ordenamiento. Las opciones de selección y desplegables utilizan valores como name-asc y name-desc, mientras que los botones alternan la dirección automáticamente.
  6. 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-desc
  • fs-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:

  1. Añade un bloque de formulario cerca de la lista de colección y coloca un campo de selección dentro.
  2. Añade con el valor al campo de selección.fs-list-elementsort-trigger
  3. 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:

  1. Añade un botón, un enlace de texto o un bloque de enlace.
  2. Añade fs-list-element="sort-trigger" y fs-list-field="price" al botón con el mismo identificador que el elemento del campo.
  3. 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.
  4. Aplica estilos a las clases combinadas is-list-asc y is-list-desc para 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:

  1. Añade un elemento desplegable y asígnale fs-list-element="sort-trigger".
  2. 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.
  3. 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:

  1. Selecciona el elemento que contiene fs-list-field y añade fs-list-fieldtype con el valor date o number.
  2. 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, o December 2021.
  3. Para los números, utiliza un valor simple como 25.89, -13, o 100.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:

  1. En Element settings > Collection list settings, activa Paginate items. Finsweet marca la paginación nativa como un paso obligatorio para usar List Load.
  2. Añade fs-list-load al mismo fs-list-element="list" elemento con el modo all, more, infinite, o pagination.
  3. 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:

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:

  1. 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>
  1. 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';
}]);
  1. 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:

  1. 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';
  });
}]);
  1. Mantén el elemento disparador oculto del sub-método anterior en la página.
  2. 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:

  1. Actualiza campos de forma masiva con PATCH /v2/collections/{collection_id}/items.
  2. Publica los cambios con POST /v2/collections/{collection_id}/items/publish, o crea y publica en un solo paso con POST /v2/collections/{collection_id}/items/live.
  3. Suscríbete a collection_item_changed con POST /v2/sites/{site_id}/webhooks para 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 con fs-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 ofrece date-desc y date-asc en 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-field identificadores 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.io dominio 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 equivalente fs-list-* en attributes.js V2, 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 son fs-cmssort-element="list" a fs-list-element="list", fs-cmssort-field a fs-list-field, fs-cmssort-element="trigger" a fs-list-element="sort-trigger", y fs-cmssort-type a fs-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.

Finsweet-List-Sort
Finsweet-List-Sort
Joined in

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.

→
↗
►
↓
←
↑
Instalar aplicación

Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.


Other Navegación por facetas integrations

Other Navegación por facetas integrations

MixItUp

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.

Navegación por facetas
Más información
Haze: búsqueda rápida para Webflow

Haze: búsqueda rápida para Webflow

Búsqueda rápida para ecommerce

Navegación por facetas
Más información
Biblioteca CMS: Ordenar

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!

Navegación por facetas
Más información
Biblioteca CMS: Filtro

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!

Navegación por facetas
Más información

Integraciones relacionadas

No se encontraron elementos.

Empieza gratis

Prueba Webflow todo el tiempo que quieras con nuestro plan Starter gratuito. Compra un plan de sitio de pago para publicar, alojar y desbloquear funciones adicionales.

Empieza, es gratis