Navegación de secciones

Las páginas de una sección se escriben una vez, como su navegación, y se muestran como la aplicación elija: pestañas bajo el encabezado, como en las otras páginas de esta sección, o el menú lateral representando la sección mientras uno está en ella — como en esta página, cuyo menú a la izquierda es de esta sección.

Escribiéndolo

El diseño de una sección establece page_section_navigation: qué es la sección (etiqueta, href), para qué se deja (volver), y sus vistas (elementos), cada una una ruta que el lector puede abrir — las demás quedan fuera. Un elemento permanece iluminado en una familia de páginas (coincidencia), y puede tener vistas propias (hijos).

{%- set page_section_navigation = {
    label: organization.name,
    href: path('organization_show', { id: organization.id }),
    back: { href: path('organization_index'), label: 'Organizations' },
    items: [
        { label: 'Overview', icon: 'ph:bold/gauge', route: 'organization_show', params: { id: organization.id } },
        { label: 'Accounting', icon: 'ph:bold/calculator', route: 'accounting_show', params: { id: ledger.id }, children: [
            { label: 'Bank', icon: 'ph:bold/bank', route: 'accounting_bank_index', params: { ledger: ledger.id }, match: 'accounting_bank_' },
        ] },
    ],
} -%}

Dibujándolo

layout_section_navigation dice cómo: pestañas por defecto, que muestran el nivel en el que se encuentra la página — los hijos de una vista bajo el camino de regreso a la sección — o menú, que muestra la sección completa, el camino de regreso en la parte superior y la vista que sostiene la página desplegada.

{# The app's layout: every section takes the side menu while one is in it. #}
{%- set layout_section_navigation = 'menu' -%}