Tabla-de-contenido-Finsweet
Conecta Finsweet Table of Contents con Webflow para generar automáticamente una navegación con enlaces de anclaje a partir de los encabezados de tu contenido.
Webflow renderiza encabezados dentro del contenido Rich Text, pero no crea una tabla de contenido a partir de ellos de forma automática. Toca crear los enlaces de anclaje para artículos largos a mano, asignar un ID a cada encabezado y mantener sincronizada la lista de la barra lateral. Cuando los editores actualizan una publicación en el CMS de Webflow, alguien tiene que rehacer esa lista para que coincida con los nuevos encabezados.
Finsweet Table of Contents resuelve ese problema como por arte de magia con un script en el lado del cliente y dos atributos personalizados. Lee los encabezados H2–H6 dentro de un Rich Text Block o Div Block y genera enlaces de anclaje anidados al instante. Al hacer clic en un enlace, la página se desliza suavemente hasta su sección, y el enlace activo adopta el estado Current nativo a medida que los lectores hacen scroll. Es gratis y no necesita cuentas ni servidores externos.
Los freelancers y las agencias lo eligen para las entregas a clientes porque la configuración funciona sin necesidad de mantenimiento continuo. Los especialistas en marketing de contenidos obtienen una navegación por secciones que se regenera con cada edición en el CMS. Es ideal para blogs, sitios de documentación, páginas de cursos y bibliotecas de recursos basados en contenido extenso en Webflow.
Cómo integrar Finsweet-table-of-contents con Webflow
¿Qué es Finsweet-table-of-contents? Finsweet Table of Contents es una de las 28 soluciones de Attributes by Finsweet, una librería gratuita repleta de funciones para sitios de Webflow que se configuran mediante atributos HTML personalizados. Genera una tabla de contenido a partir de encabezados H2–H6 dentro de un Rich Text Block o Div Block, tanto en páginas estáticas como en plantillas de CMS. Un único script alojado en CDN potencia toda la librería: sin aplicaciones que instalar ni cuentas que crear.
Los equipos añaden esta integración cuando los artículos del CMS superan varias pantallas y los lectores necesitan una forma de saltar entre secciones. La misma configuración funciona en una página de destino estática o en toda una plantilla de colección de blog. Esta guía utiliza Attributes v2, la versión actual. La versión anterior v1 (Attributes Legacy) está obsoleta y ya no cuenta con soporte.
La integración de Finsweet Table of Contents con Webflow admite dos enfoques:
- Los atributos personalizados combinados con el script universal generan la tabla de contenido y gestionan el scroll suave y el estado activo sin que tengas que escribir ni una sola línea de código.
- La API de callbacks de Finsweet Attributes y la Data API de Webflow te dan control programático total sobre los tiempos de inicialización y el contenido del CMS, aunque requieren desarrollo en JavaScript o del lado del servidor.
La mayoría de los sitios solo necesitan la configuración mediante atributos; la ruta de la API cubre casos excepcionales de sincronización del CMS y publicaciones automatizadas.
Añadir la tabla de contenido con atributos personalizados
Añade un script a tu código del head, etiqueta dos elementos con atributos, estructura una plantilla de enlace y publica. La mayoría de los proyectos solo necesitan este camino. El código personalizado requiere un plan de sitio de pago, por lo que el plan gratuito Starter no puede ejecutar el script. La referencia completa de atributos se encuentra en la documentación de Table of Contents.
Instalar el script universal
El script v2 se comparte en toda la biblioteca de Attributes. Según la documentación de Finsweet, "solo necesitas incluirlo una vez, incluso si tienes varias soluciones de Attributes en la página".
<script async type="module"
src="https://cdn.jsdelivr.net/npm/@finsweet/attributes@2/attributes.js"
fs-toc
></script>
Para añadir el script:
- Copia la etiqueta del script de arriba.
- Entra en Site settings > Custom code, pégalo en la sección Head code y haz clic en Save changes. Consulta Custom code in head and body tags para ver las dos opciones de ubicación disponibles.
- Para cargarlo solo en una página, abre la Configuración de la página y pega el código en la sección de la etiqueta Inside
<head>en su lugar.
También puedes pegar el script en un elemento Code Embed en el lienzo, aunque la guía de configuración de Finsweet lo coloca en la etiqueta <head>.
Etiqueta el contenido y crea la plantilla de enlace
Según la documentación de Finsweet, "Todas las implementaciones de tablas de contenido deben comenzar con el elemento H2. No es posible iniciar la tabla de contenido con un nivel de encabezado distinto a H2, como H1 o H3". El H1 siempre se ignora.
Para configurar los elementos:
- Selecciona el bloque de texto enriquecido (Rich Text Block) o el bloque div (Div Block) que contiene tu contenido. Ve a Configuración del elemento > Atributos personalizados, haz clic en el icono de más y añade
fs-toc-elementcon el valorcontents. - Añade un bloque de enlace (Link Block), un enlace de texto o un bloque de texto donde deba aparecer la tabla de contenido. Asígnale
fs-toc-elementcon el valorlink. - Estructura las plantillas de enlace mediante anidamiento: "Cada plantilla de enlace de encabezado debe estar encerrada en un
divcontenedor, y estedivcontenedor debe ser hijo deldivasociado con el nivel de encabezado anterior". - Configura la URL de cada plantilla de enlace a la URL de la página actual y, a continuación, dale estilo a la clase verde "Current" en el panel de estilos. El resaltado del estado activo no requiere atributos adicionales.
- Publica el sitio.
Los atributos opcionales y las directivas de texto plano refinan el resultado:
fs-toc-offsettopyfs-toc-offsetbottomaceptan cualquier valor CSS, como2rem, para controlar dónde se activa el estado "Current" bajo una barra de navegación fija.fs-toc-hideurlhash="true"evita que los ID de los encabezados aparezcan en la URL durante la navegación.fs-toc-instance="IDENTIFIER"en un contenedor padre común permite ejecutar varias tablas de contenido independientes en una misma página.[fs-toc-omit]escrito como texto plano antes de un encabezado lo excluye de la tabla de contenido.[fs-toc-h#], como[fs-toc-h4], cambia el nivel de un encabezado en la tabla de contenido sin modificarlo en la página.fs-toc-element="ix-trigger"en un div dentro de un contenedor de encabezado activa las interacciones de Webflow cuando un enlace se vuelve actual o inactivo.
Una tabla de contenido no puede abarcar varios contenedores de contenido; según la documentación, "Esta solución no puede utilizarse para generar una única tabla de contenido basada en varios elementos de texto enriquecido". El método del bloque div "remodelará ligeramente el código HTML de tu página" agrupando cada encabezado con su contenido siguiente. Esto puede afectar a los diseños dependiendo de las propiedades de visualización (Display) del div. Asegúrate también de realizar pruebas en un dominio publicado, ya que los scripts no se ejecutan en la vista previa de Webflow.
Construye con la API de datos de Webflow y las funciones de callback de Finsweet
La tabla de contenido de Finsweet no tiene API REST, webhooks ni interfaz del lado del servidor. Finsweet describe su API de atributos como una capa de integración para las soluciones de atributos del lado del cliente. Por lo tanto, el trabajo de programación se divide en dos. El JavaScript del lado del cliente se conecta a la biblioteca después de que esta se inicializa, y la API de datos de Webflow gestiona el contenido del CMS que lee la tabla de contenido.
- La API de Finsweet Attributes se encarga de los callbacks en el lado del cliente y de la reinicialización de las soluciones de Attributes
- La Data API v2 de Webflow gestiona colecciones de CMS y elementos de colección en
https://api.webflow.com/v2 - Los webhooks de Webflow activan eventos como
collection_item_publishedcuando los artículos se publican
Las devoluciones de llamada (callbacks) del lado del cliente gestionan el tiempo de inicialización. La API de datos de Webflow gestiona la publicación del CMS.
Ejecutar código después de que se inicialice la tabla de contenido
Varios hilos de la comunidad en el foro de Finsweet señalan que la generación de la tabla de contenido a veces falla en páginas de CMS con Rich Text aunque funcione de maravilla en páginas estáticas; posiblemente porque el script se ejecuta antes de que Webflow renderice el contenido del CMS. Finsweet no ha publicado una solución oficial. Puedes usar la API de callbacks como un apaño práctico, tal y como se documenta en este hilo del foro.
Para conectarse a la inicialización:
- Añada este fragmento a su página después del script universal:
window.fsAttributes = window.fsAttributes || [];
window.fsAttributes.push([
'toc',
(tocInstances) => {
console.log('toc Successfully loaded!');
// Add code here
},
]);
- Coloque cualquier lógica dependiente dentro de la devolución de llamada, como restablecer las interacciones de Webflow con , un patrón que se muestra en
window.Webflow.require('ix2').init()esta solución del foro. - Para casos como el cambio de desplazamientos (offsets) entre puntos de interrupción (breakpoints), elimine y reconstruya la instancia:
window.fsAttributes.toc.destroy();
window.fsAttributes.toc.init();
El patrón de destruir y reinicializar surge de una solución del foro de Finsweet. Es una técnica documentada por la comunidad y no forma parte de la referencia oficial de atributos.
Crear artículos del CMS que generen una tabla de contenido
Las migraciones de contenido y las canalizaciones de publicación headless pueden crear los artículos que lee la tabla de contenido. Una vez que se publica un elemento, la configuración de atributos en la página de plantilla de la colección renderiza la navegación en el lado del cliente; no existe ni se necesita ninguna llamada por parte de Finsweet.
Para publicar un artículo a través de la API:
- Envíe con que contenga , , y el campo de cuerpo de texto enriquecido. Esto requiere el ámbito, según la
POST https://api.webflow.com/v2/collections/{collection_id}/itemsfieldDatanameslugCMS:writereferencia de Crear elemento. - Para migraciones, acepta hasta 100 elementos por solicitud, según la
POST https://api.webflow.com/v2/collections/{collection_id}/items/bulkreferencia de creación masiva. - Publique con y los ID de elemento devueltos, según la
POST https://api.webflow.com/v2/collections/{collection_id}/items/publishreferencia de publicación.
Para actuar después de la publicación, registre un webhook para collection_item_published y active limpiezas de caché o actualizaciones del índice de búsqueda desde sus propios sistemas.
¿Qué puede construir con la integración de la tabla de contenido de Finsweet para Webflow?
Estas son configuraciones funcionales creadas con la tabla de contenido de Finsweet en Webflow.
- Artículos de blog con navegación fija por secciones: El clonable Enhanced Table of Contents aprovecha la solución de Finsweet y le añade una sección fija y desplegable para móviles, para que los lectores puedan saltar entre secciones H2 estén donde estén en la página.
- Documentación con navegación jerárquica: El propio sitio de documentación de Attributes de Finsweet funciona con esta librería y combina la navegación generada con desplegables en acordeón, búsqueda por palabras clave y filtros por categoría.
- Menús de contenido para artículos de CMS: CMS Anchor Links v2 crea un menú de secciones para artículos de blog largos a partir de Rich Text vinculado a CMS, sin tener que configurar nada post por post una vez etiquetada la plantilla.
- Índices de cursos y páginas con secciones apiladas: Las páginas de cursos con índices de lecciones funcionan igual de bien, y los identificadores de instancia permiten que cada bloque de contenido apilado tenga su propio índice independiente.
Si necesitas más control sobre la publicación y migración automatizadas, la ruta de integración mediante API cubre esos casos con total flexibilidad.
Preguntas frecuentes
Sí. La integración depende de un script en el código de la cabecera (head) de tu sitio y, según la documentación sobre código personalizado, «El código personalizado es una función de los planes de sitio de pago. Para añadir código personalizado a tu sitio, tendrás que actualizar a un plan de sitio de pago». El plan Starter gratuito no permite incrustar el script, así que tenlo en cuenta al planificar tus demostraciones.
Porque el código personalizado y los scripts solo se activan en el sitio publicado, tal como indica la documentación de páginas de colección. Publica en tu dominio de pruebas webflow.io para comprobar cómo funcionan los enlaces generados, el desplazamiento suave y los estilos del estado Current antes de lanzarlo a producción.
Sí. La documentación oficial confirma que
fs-toc-element="contents"funciona en bloques de texto enriquecido, incluidos los conectados al CMS, y en bloques Div con encabezados como elementos secundarios directos. Una advertencia proviene de informes de la comunidad más que de documentos oficiales: un hilo del foro de Finsweet describe fallos en la generación en páginas de texto enriquecido del CMS cuando la misma configuración funciona en páginas estáticas, sin una resolución oficial documentada.No. La herramienta funciona exclusivamente en el navegador sin API ni webhooks, por lo que ni Zapier ni Make disponen de un conector para Finsweet. Lo que sí puedes automatizar es el contenido del CMS de Webflow que lee la tabla de contenido. La integración de Webflow para Zapier admite las acciones Create/Update Item y Create/Update Live Item, y los módulos de Webflow en Make incluyen Create Item y Get Collection entre sus 40 opciones disponibles. Zapier y Make se conectan directamente con Webflow, no con Finsweet.
Usa la v2. Finsweet indica que "Attributes Legacy seguirá funcionando en proyectos existentes, pero ten en cuenta que hemos dejado de ofrecer soporte para esta versión". Ambas versiones no pueden ejecutarse en la misma página, aunque sí en páginas distintas de un mismo sitio, lo que ofrece a los equipos en migración una ruta página por página. Comienza los nuevos desarrollos con la guía de la tabla de contenido v2, que incluye la etiqueta de script actual y la referencia completa de atributos.
Descripción
Genera una navegación con enlaces de anclaje a partir de encabezados H2–H6 en el contenido de Rich Text o Div Block de Webflow. La configuración requiere un script en el código del head y dos atributos personalizados.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
Boosters de Flowbase
Añade texto tipo máquina de escribir, contadores, cuentas atrás y deslizadores de imágenes a Webflow con Flowbase Boosters: scripts basados en atributos, sin necesidad de escribir JavaScript.

Better Shadows
Better Shadows genera valores de box-shadow en capas de CSS y los aplica a las clases de Webflow con un solo clic, logrando una profundidad que de otro modo tendrías que ajustar capa por capa.
gFLUO
Conecta gFLUO con Webflow para aplicar animaciones de texto GSAP desde el panel de Aplicaciones, sin necesidad de escribir código JavaScript.

Flowmonk
Flowmonk sincroniza los datos del CMS de Webflow con Airtable, permitiéndote gestionar tu contenido en Webflow mientras aprovechas las funciones de base de datos de Airtable para análisis, colaboración y automatización.
Flowtrix Schema
Conecta Flowtrix Schema, una aplicación de datos estructurados sin código para marcado JSON-LD, con Webflow para añadir esquemas compatibles con Google a páginas estáticas y CMS sin necesidad de programar.

Arvow

Timeline
Timeline proporciona una infraestructura de contenido cronológico para sitios de Webflow sin necesidad de desarrollo a medida.
Azwedo
Instala las aplicaciones de Webflow aprobadas por Azwedo para añadir bibliotecas de iconos, textos generados por IA, componentes preconstruidos y edición de SVG directamente en Webflow.
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.


