Shortcode web_table_of_contents
El shortcode web_table_of_contents renderiza el componente de tabla de contenidos.
Los atributos siguientes coinciden con los controles actuales de Page Builder y con el resultado público. Usa la sintaxis raw únicamente para contenido revisado que no se pueda mantener mediante los controles visuales.
Uso
Coloca el shortcode en el contenido cuyos encabezados quieras listar. Indexa los encabezados renderizados en ese contenido, incluidos los bloques anidados y los shortcodes. En una llamada a plantilla independiente, usa el contenido guardado de la página actual. Sin una fuente utilizable o encabezados coincidentes, no renderiza nada.
[web_table_of_contents]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
table_of_contents_title |
— | Cadena, salvo que se indique lo contrario | Introduce el título de la tabla de contenidos. |
table_of_contents_style |
numerated |
numerated, dotted, none |
Elige el estilo de lista. |
table_of_contents_included_headers |
1,2,3,4,5,6 |
Niveles 1–6 separados por comas | Selecciona los niveles de encabezado, por ejemplo 2,3. |
accessible_name |
Table of contents | Texto sin formato | Etiqueta opcional para el punto de referencia de navegación. |
device_visibility |
— | Cadena, salvo que se indique lo contrario | Aplica la regla de visibilidad responsiva seleccionada. |
el_id |
— | ID HTML único válido | Introduce el ID de la sección (Nota: asegúrate de que sea único y válido según la especificación w3c). |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas aplicar un estilo diferente a un elemento de contenido concreto, usa este campo para añadir un nombre de clase y, a continuación, haz referencia a él en tu archivo css. |
Verificación
Verifica web_table_of_contents con contenido representativo, su estado vacío y cada rango responsivo habilitado. Presta especial atención a table_of_contents_title y table_of_contents_style.
Se conservan los anclajes de encabezado únicos creados por el autor; los ID que faltan o que entran en conflicto reciben destinos generados distintos. Establece anclajes de encabezado explícitos para enlaces profundos externos estables. Renombrar un encabezado puede cambiar su destino generado. Los encabezados eliminados por reglas de permisos no se indexan.
El shortcode comparte su renderizado y su script de desplazamiento condicional existente con Gutenberg Table of Contents. Los enlaces ordinarios a encabezados visibles funcionan sin JavaScript. Los índices Legacy almacenados en caché cuyos encabezados no tienen ID generados conservan sus enlaces basados en títulos a través del script de desplazamiento compartido. El script respeta el movimiento reducido y los encabezados opcionales; los contenedores interactivos necesitan sus scripts normales. No se añade ninguna hoja de estilos de frontend específica del índice.