Finsweet Attributes: Integración de la Tabla de Contenidos en Webflow

Conecta Finsweet Attributes: Table of Contents con Webflow para generar tablas de contenido automáticas y clicables a partir de tus elementos de encabezado.

→
↗
►
↓
←
↑
Instalar aplicación
→
↗
►
↓
←
↑
Ver sitio web
→
↗
►
↓
←
↑
Ver lección
→
↗
►
↓
←
↑
Configuración de registros A
→
↗
►
↓
←
↑
Configuración de registros CNAME
Finsweet Attributes: Integración de la Tabla de Contenidos en Webflow

Cómo integrar Finsweet Attributes: Table of Contents con Webflow

¿Qué es Finsweet Attributes: Table of Contents? Es una solución gratuita del lado del cliente que lee los encabezados dentro de un Rich Text Block o Div Block de Webflow y crea con ellos una tabla de contenido interactiva. No guarda nada ni saca datos del navegador, así que olvídate de sincronizaciones externas o llamadas a las API de Webflow.

La solución de tabla de contenido solo necesita un script en el head de la página y un puñado de atributos personalizados en tus elementos de Webflow. Esa es toda la magia: ni apps que instalar ni cuentas que conectar.

Aquí la versión importa más que con la mayoría de scripts. La versión actual es Attributes V2, que carga cada función desde una única biblioteca universal. La versión anterior pasó a llamarse Attributes Legacy (V1), y ambas se llevan fatal en una misma página. Todo lo que verás abajo usa la sintaxis V2.

Añade el script y configura los atributos

En cuanto el script está en su sitio, todo el montaje ocurre dentro de Webflow. Añade la biblioteca al código del head de tu página y define qué elemento contiene los encabezados y cuál hará de plantilla para los enlaces.

Pega esto en la sección de Custom Code de tu página, dentro de Head Code, o en la configuración general del sitio si quieres disfrutarlo en todas las páginas:

<script async type="module" src="https://cdn.jsdelivr.net/npm/@finsweet/attributes@2/attributes.js" fs-toc></script>

La fs-toc etiqueta en el script es lo que le indica a la biblioteca universal que cargue esta solución en particular. Luego, aplica estos atributos en el panel de configuración de elementos:

  • Contenedor de contenido: Añade fs-toc-element="contents" al bloque de texto enriquecido o bloque Div que contiene los encabezados que quieres listar.
  • Plantilla de enlace: Añade fs-toc-element="link" al bloque de enlace o enlace de texto que la solución clonará una vez por cada encabezado que encuentre.
  • Contenedor de la tabla: Añade fs-toc-element="table" al elemento que debe recibir los enlaces generados; esto es opcional, ya que de lo contrario la solución utiliza el elemento padre de la plantilla de enlace.
  • Activador de interacción: Añade fs-toc-element="ix-trigger" a un Div dentro de un contenedor de encabezado cuando quieras que se ejecute una interacción de Webflow a medida que esa sección se vuelve activa.

Los cuatro se colocan en el área de atributos personalizados del panel de configuración de elementos, por lo que el único código que escribes es la etiqueta del script. La solución lee entonces los encabezados H2 a H6 dentro del elemento de contenido y completa tu plantilla de enlace. El H1 se omite a propósito, ya que pertenece al título de la página y no a una sección.

Cuatro configuraciones opcionales cubren el comportamiento que la mayoría de las páginas terminan ajustando:

  • fs-toc-offsettop: Acepta una longitud CSS como 80px y detiene el desplazamiento a esa distancia por encima del encabezado de destino, que es lo que necesita un encabezado fijo.
  • fs-toc-offsetbottom: Recibe una medida CSS y añade ese mismo respiro debajo del encabezado de destino al hacer scroll.
  • fs-toc-hideurlhash: Configúralo en true para mantener el ancla del encabezado fuera de la barra de direcciones del navegador cuando un lector hace clic en una entrada.
  • fs-toc-anchor: Asigna un ID de anclaje personalizado a un encabezado concreto en lugar de dejar que la herramienta lo invente a partir del texto.

Los tres primeros se colocan en el elemento de contenido, mientras que el va en el encabezado individual. Dos marcadores en línea controlan la tabla en sí: coloca en el texto de un encabezado para excluirlo de la lista, o para renderizarlo en un nivel de anidamiento diferente. Ambos marcadores se eliminan del texto visible del encabezado.fs-toc-anchor[fs-toc-omit][fs-toc-h3]

Los enlaces generados funcionan con el estado nativo Current de Webflow, por lo que la entrada activa adquiere la clase a medida que el lector se desplaza. Selecciona el elemento de enlace, cambia al estado w--currentCurrent en el panel de estilo y dale formato allí.

Algo a tener en cuenta: el código personalizado no se ejecuta en el lienzo de Webflow ni en la vista previa, por lo que la tabla parecerá vacía hasta que publiques. Prueba la navegación en una versión de prueba o producción en lugar de en el editor, y considera que una tabla en blanco en la vista previa es el comportamiento esperado, no un error.

Ejecuta más de una tabla de contenido en una página

Una página con dos áreas de contenido independientes necesita dos tablas, y los nombres de instancia son la forma de emparejar cada tabla con su contenido. Cada elemento que pertenece a una tabla comparte el mismo valor de .fs-toc-instance

Para una tabla en el pie de página junto a la principal:

<div fs-toc-element="contents" fs-toc-instance="footer">
  <h2>Section heading</h2>
</div>

<div fs-toc-element="table" fs-toc-instance="footer">
  <a fs-toc-element="link" fs-toc-instance="footer" href="#">Section heading</a>
</div>

Aquí es donde los tutoriales antiguos te llevarán por mal camino. La V1 de Attributes separaba las instancias con sufijos numéricos en los valores de los atributos, como y . La V2 lo reemplazó por , así que cualquier guía que todavía muestre valores con sufijos está enseñando una sintaxis obsoleta que la biblioteca V2 no leerá.contents-1contents-2fs-toc-instance

Implementación con páginas de plantilla CMS

La solución lee un campo de texto enriquecido (Rich Text) de CMS exactamente igual que uno estático, con un límite estricto que conviene conocer antes de diseñar la página: construye una tabla a partir de un único elemento de contenido, nunca de varios.

Para una página de plantilla de colección:

  1. Aplica al elemento de texto enriquecido o al bloque Div que contiene los encabezados.fs-toc-element="contents"
  2. Añade un elemento de enlace con para que actúe como plantilla para cada entrada generada.fs-toc-element="link"
  3. Publica y prueba con contenido real de la colección, ya que el script solo se ejecuta en un sitio publicado.
  4. Si los encabezados no se detectan, comprueba si la estructura de tu contenido añade elementos contenedores entre el elemento de contenido y los encabezados.

La propia Finsweet avisa de que no se puede generar un único índice a partir de varios elementos de texto enriquecido, y un concurrido hilo de la comunidad de Finsweet recopila los tropiezos habituales con el Rich Text del CMS. Para contenido gestionado en Webflow CMS, la fórmula infalible es un solo elemento de contenido por página de plantilla.

Añadir activadores de interacción

La solución puede activar interacciones de Webflow a medida que cada sección se vuelve activa. Añade un Div dentro del contenedor de tu encabezado, aplícale y luego crea la interacción sobre ese elemento. Esto es ideal para equipos que ya se sienten cómodos creando interacciones. Si no es tu caso, dar estilo al estado Current consigue casi el mismo efecto con mucho menos trabajo.fs-toc-element="ix-trigger"

Lo que puedes construir con la tabla de contenido de Finsweet y Webflow

Las páginas largas son las que más se benefician de esto, porque la tabla se deriva de los encabezados que ya existen en lugar de tener que mantenerla a mano. Cambia el nombre de una sección y la entrada se actualizará sola.

Las configuraciones comunes incluyen:

  • Documentación con navegación anidada: Genera una barra lateral fiel a la jerarquía de encabezados del artículo, para que cualquiera pueda reorganizar una página sin tener que rehacer los menús a mano.
  • Artículos de blog con índice fijo: Fija la tabla junto a un post extenso y deja que el estado activo guíe a los lectores para que sepan siempre por dónde van.
  • Páginas de cursos y lecciones: Ofrece a los alumnos un mapa claro de cada sección del módulo y un atajo para saltar directamente a repasar lo que necesiten.
  • Artículos de bases de conocimiento: Permite que los usuarios examinen la estructura de la página de un vistazo y vayan directos al grano con la respuesta que buscan.

Todas estas opciones dependen de colocar el mismo script en el lugar indicado, y vale la pena resolverlo de una vez en lugar de ir página por página. Nuestra guía sobre cómo aplicar código personalizado mediante API te muestra cómo inyectar ese código en el head de múltiples páginas como por arte de magia.

Una jerarquía de encabezados desordenada suele ser lo primero que rompe un índice automático cuando el volumen de contenido crece. Conecta el servidor MCP de Webflow y pon a un agente a auditar los niveles de encabezado en tus colecciones para meter en cintura las páginas donde la estructura se haya desmadrado.

Preguntas frecuentes

  • Añade la etiqueta script en la sección de Código personalizado bajo Head Code, o añádela en la configuración del sitio para cargarla en todas las páginas. Attributes V2 carga un archivo de biblioteca universal, y tú identificas la solución con un fs-toc flag en la propia etiqueta script. Se carga con async type="module" para no bloquear el renderizado. Una vez colocado el script, configura tus fs-toc-element atributos en el panel de configuración de elementos.

  • No. La solución solo rastrea encabezados de H2 a H6, así que pasará por alto los H1 aunque estén dentro del elemento del índice. Esto encaja a la perfección con las recomendaciones de HTML semántico de Webflow y la clásica regla de oro de reservar el H1 para el título de la página. Deja el H1 fuera de tu contenedor de contenido y estructura las secciones de H2 a H6.

  • Los enlaces generados funcionan con el estado "Actual" nativo de Webflow, por lo que la entrada activa adopta la w--current clase a medida que el lector hace scroll. Selecciona el elemento de enlace de tu tabla de contenidos, cambia al estado Actual en el panel de Estilo y dale formato allí. Si el resaltado salta demasiado rápido en encabezados muy cercanos, aumenta el fs-toc-offsettop valor en el elemento de contenidos.

  • Usa V2 para todo lo nuevo. Finsweet renombró la versión anterior como Attributes Legacy (V1) y sigue dándole soporte, pero V2 es donde se centra el desarrollo actual y carga todas las soluciones desde un único archivo de biblioteca. Ambas versiones no pueden ejecutarse en la misma página, así que si un sitio aún usa V1, debe mantener las versiones en páginas separadas.

  • Dale estilo en Webflow con el panel de Estilo, igual que harías con cualquier otro enlace o contenedor. La solución solo genera el marcado y aplica el estado "Actual", dejando la tipografía, el color, el espaciado y el diseño totalmente en tus manos. Para comportamientos que el panel de Estilo no alcanza, como el desplazamiento bajo un encabezado fijo, usa los atributos fs-toc-offsettop y fs-toc-offsetbottom en el elemento de contenidos.

Finsweet Attributes: Integración de la Tabla de Contenidos en Webflow
Finsweet Attributes: Integración de la Tabla de Contenidos en Webflow
Joined in

Descripción

Finsweet Attributes: Table of Contents lee los elementos de encabezado (H2 a H6) dentro de un bloque de texto enriquecido (Rich Text) o un bloque Div de Webflow y genera anclas vinculadas y clicables a partir de ellos. Gestiona el desplazamiento suave con compensaciones configurables y marca la entrada activa mediante el estado "Current" nativo de Webflow. Se pueden ejecutar varias tablas independientes en una misma página usando nombres de instancia, y Attributes V2 carga todo desde un único archivo de biblioteca universal.

→
↗
►
↓
←
↑
Instalar aplicación

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


Other Marketing de contenidos integrations

Other Marketing de contenidos integrations

PowerImporter

PowerImporter

Conecta PowerImporter Airtable Sync, una herramienta de sincronización de datos unidireccional, con Webflow para enviar automáticamente el contenido de Airtable a las colecciones de CMS sin escribir código.

Marketing de contenidos
Más información
AirOps

AirOps

Conecta AirOps, una plataforma de operaciones de contenido con IA, con Webflow para investigar, redactar y publicar contenido directamente en las colecciones de tu CMS sin tener que cambiar de herramienta.

Marketing de contenidos
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