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.

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

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:

  1. Copia la etiqueta del script de arriba.
  2. 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.
  3. 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:

  1. 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-element con el valor contents.
  2. 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-element con el valor link.
  3. Estructura las plantillas de enlace mediante anidamiento: "Cada plantilla de enlace de encabezado debe estar encerrada en un div contenedor, y este div contenedor debe ser hijo del div asociado con el nivel de encabezado anterior".
  4. 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.
  5. Publica el sitio.

Los atributos opcionales y las directivas de texto plano refinan el resultado:

  • fs-toc-offsettop y fs-toc-offsetbottom aceptan cualquier valor CSS, como 2rem, 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.

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:

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

  1. 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.
  2. 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.
  3. 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.

Tabla-de-contenido-Finsweet
Tabla-de-contenido-Finsweet
Joined in

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.

→
↗
►
↓
←
↑
Instalar aplicación

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


Other Biblioteca de plugins e integraciones integrations

Other Biblioteca de plugins e integraciones integrations

Typed.js

Typed.js

Añade Typed.js a Webflow con código personalizado para escribir y repetir el texto de un titular principal, o utiliza palabras rotativas desde campos del CMS.

Biblioteca de plugins e integraciones
Más información
Sweet Text de Finsweet

Sweet Text de Finsweet

Biblioteca de plugins e integraciones
Más información
Scrollbar Styler de Finsweet

Scrollbar Styler de Finsweet

Dale estilo a las barras de desplazamiento de Webflow visualmente con el generador de CSS gratuito de Finsweet, pega el código en tu sitio y añade las propiedades estándar para una compatibilidad total con navegadores.

Biblioteca de plugins e integraciones
Más información
React

React

Biblioteca de plugins e integraciones
Más información
POWR

POWR

Añade formularios, ventanas emergentes, temporizadores de cuenta atrás y chat en vivo de POWR a un sitio de Webflow mediante un elemento Code Embed o código en el pie de página, y envía las respuestas de los formularios al CMS a través de Zapier.

Biblioteca de plugins e integraciones
Más información
One2 Menu

One2 Menu

Pega un fragmento de One2 Menu en Webflow y el menú de tu restaurante se mantendrá actualizado desde el panel de control de One2.

Biblioteca de plugins e integraciones
Más información
MathJax

MathJax

Conecta MathJax, un motor de visualización matemática de código abierto, con Webflow para renderizar ecuaciones LaTeX como fórmulas tipográficas con accesibilidad integrada, compatibilidad con lectores de pantalla y consistencia entre navegadores.

Biblioteca de plugins e integraciones
Más información
Listen Notes

Listen Notes

Conecta Listen Notes, un motor de búsqueda y API de podcasts, con Webflow para insertar reproductores de episodios, añadir búsquedas de podcasts y completar colecciones del CMS con metadatos de más de 3,7 millones de podcasts.

Biblioteca de plugins e integraciones
Más información
Isótopo

Isótopo

Conecta Isotope, una biblioteca de diseño JavaScript de Metafizzy, con Webflow para crear cuadrículas masonry animadas con filtrado, ordenación y transiciones CSS del lado del cliente en las Listas de colección del CMS.

Biblioteca de plugins e integraciones
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