Referencia de la navegación de categorías
La navegación se renderiza mediante [category_nav] y se inyecta automáticamente en las plantillas de archivo que aún no la contienen. Esta página documenta el comportamiento en el que una integración puede basarse.
Contextos
La navegación resuelve uno de dos contextos:
| Contexto | Cuándo |
|---|---|
| Archivo de categoría | La solicitud es un archivo de categoría de menú |
| Archivo de menú | La solicitud es un archivo del tipo de contenido de menú |
Fuera de esos casos, no renderiza nada.
Modos de renderizado
Dos ejes deciden el marcado:
Jerárquico o plano, según el ajuste por tipo de menú. Las cartas de vinos usan el modo plano por defecto; los demás tipos usan el modo anidado por defecto.
Enlaces o anclas. En un archivo de categoría, las entradas enlazan a las categorías hermanas. En un archivo de menú, donde todas las secciones están en una misma página, las entradas son anclas a las secciones.
Los identificadores de las anclas se derivan de la taxonomía y del término, por lo que son estables entre renderizados del mismo término.
Orden
Los términos se leen con la posición almacenada en la metaclave de término tax_position, en orden ascendente. Cualquier navegación personalizada debe reproducir ese orden para coincidir con el resto del producto.
Términos que se omiten
La navegación se mantiene deliberadamente en silencio cuando no hay nada que navegar:
- los términos sin entradas, directamente o en sus descendientes, no se renderizan;
- una navegación que contendría un único término no se renderiza en absoluto.
Que [category_nav] devuelva una salida vacía es normal, no un error.
Los elementos de utilidad
Se añaden hasta tres controles después de las entradas de categoría, cada uno procedente de un ajuste por tipo de menú:
| Ajuste | Control |
|---|---|
| Alternador de filtros | Abre el panel de filtros de alérgenos |
| Alternador de favoritos | Abre la vista de favoritos |
| Alternador de idioma | Abre el selector de idioma |
Se renderizan como alternadores que apuntan a los correspondientes paneles fuera de lienzo, de modo que un archivo personalizado debe proporcionar esos paneles para que los controles resulten útiles.
Colores
Tres ajustes de paleta determinan la apariencia de la navegación: el color del divisor, el color del texto usado por los enlaces y el indicador activo, y el color de fondo usado detrás de la barra y sus fundidos laterales.
Se resuelven en ranuras de paleta en lugar de valores fijos, por lo que una hoja de estilos personalizada debería leer las mismas variables en lugar de codificar colores de forma rígida.
Atributos
[category_nav] acepta un atributo:
| Atributo | Valor por defecto | Efecto |
|---|---|---|
show_subnav |
true |
Si se renderizan las subsecciones de la categoría actual |
El modo plano/anidado y los alternadores de utilidad son ajustes, no atributos, de modo que el mismo marcado se comporta de forma coherente en todos los archivos de un tipo de menú.
Inyección automática
El marcado de archivo que pasa por pom_archive_template_html recibe la navegación cuando todavía no contiene [category_nav]. Para controlar la ubicación con precisión, incluye el shortcode en tu marcado y la inyección no se aplicará.
Guía de integración
- Prefiere el shortcode antes que construir la navegación desde
get_terms(). - Si debes construir la tuya propia, reproduce el orden de
tax_positiony la supresión de términos vacíos. - Proporciona los paneles fuera de lienzo que esperan los alternadores de utilidad.
- No asumas un número fijo de entradas; la barra es desplazable horizontalmente por diseño.