Dash Diseño de múltiples páginas

En el desarrollo moderno de aplicaciones web, las aplicaciones de una sola página (SPA) y las aplicaciones de múltiples páginas (MPA) son dos patrones de arquitectura comunes.

Las aplicaciones de una sola página suelen ofrecer una experiencia de usuario fluida mediante la carga dinámica de contenido, mientras que las aplicaciones de múltiples páginas organizan el contenido a través de múltiples páginas independientes.

Aplicación de una sola página vs aplicación de múltiples páginas

En una aplicación de una sola página, todo el contenido se carga y actualiza dinámicamente en una sola página, y el usuario cambia entre diferentes vistas haciendo clic en enlaces o botones. La ventaja de esta arquitectura es una experiencia de usuario fluida y una carga rápida de la página, pero la desventaja es que, a medida que la aplicación crece, la estructura del código puede volverse compleja.

Las aplicaciones de múltiples páginas organizan el contenido mediante múltiples páginas independientes, cada una con su propia URL y diseño. La ventaja de esta arquitectura es una estructura de código clara y fácil de mantener, pero la desventaja es que al cambiar de página hay cierta latencia de carga.


Implementación del diseño de múltiples páginas en Dash

En Dash, el diseño de múltiples páginas se puede implementar con los componentes dcc.Location y dcc.Link.

dcc.Location se utiliza para rastrear la URL de la página actual, mientras que dcc.Link se utiliza para navegar entre páginas. Combinando funciones de devolución de llamada (callbacks), se puede cargar dinámicamente contenido diferente según la URL.

  • Usandodcc.Locationydcc.Linkse puede implementar un diseño de múltiples páginas.

  • Mediante funciones de devolución de llamada segúnpathnameCargar dinámicamente el contenido de la página.

  • Combinando diseño modular y parámetros de URL, se pueden construir aplicaciones de múltiples páginas más complejas.

Estructura básica del diseño de múltiples páginas

La idea central del diseño de múltiples páginas es cargar dinámicamente diferentes contenidos según la ruta (pathname) de la URL.

A continuación se presentan los pasos básicos para implementar un diseño de múltiples páginas:

Definir el diseño de la página:

  • El diseño de cada página se puede definir como una función o una variable.

  • Por ejemplo,home_layoutrepresenta la página de inicio,about_layoutrepresenta la página de acerca de.

Usardcc.Location:

  • dcc.Locationel componente se utiliza para rastrear la URL de la página actual.

  • Mediantepathnamela propiedad obtiene la ruta de la página actual.

Usardcc.Link:

  • dcc.Linkel componente se utiliza para crear enlaces de navegación entre páginas.

  • Mediantehrefla propiedad especifica la ruta de la página de destino.

Cargar dinámicamente el contenido de la página:

  • Usando funciones de devolución de llamada, segúnpathnamedevolver dinámicamente el diseño de la página correspondiente.

Ejemplo

from dash import Dash, html, dcc, Input, Output

# Crear la aplicación Dash
app = Dash(__name__)

app.layout = html.Div([
    dcc.Location(id='url', refresh=False),
    html.Div(id='page-content')
])

En el código anterior,dcc.Locationdel componenteidse establece enurl,refreshel parámetro se establece enFalse, lo que indica que la página no se recarga cuando cambia la URL.html.Div(id='page-content')es un marcador de posición que se utiliza para mostrar el contenido de diferentes páginas.

Definir el diseño de la página

A continuación, necesitamos definir los diseños de las diferentes páginas. El diseño de cada página puede ser una función o variable independiente. Por ejemplo, podemos definir los diseños de dos páginas:index_pageypage1。

Ejemplo

index_page = html.Div([
    html.H1("Inicio"),
    dcc.Link('Ir a la página 1', href='/page1')
])

page1 = html.Div([
    html.H1("Página 1"),
    dcc.Link('Volver al inicio', href='/')
])

En el código anterior,index_pagees el diseño de la página de inicio, que incluye un título y un enlace; al hacer clic en el enlace se puede saltar apage1。page1es el diseño de la página 1, que también incluye un título y un enlace para volver a la página de inicio.

Carga dinámica del diseño de la página

Finalmente, necesitamos usar funciones de devolución de llamada para cargar dinámicamente diferentes diseños de página según los cambios en la URL. La función de devolución de llamada se encarga de, segúndcc.Locationdel componentepathnamela propiedad, decidir qué diseño de página mostrar.

Ejemplo

@app.callback(Output('page-content', 'children'),
              [Input('url', 'pathname')])
def display_page(pathname):
    if pathname == '/page1':
        return page1
    else:
        return index_page

En el código anterior,display_pagela función recibepathnamecomo entrada y, segúnpathnameel valor de, devuelve el diseño de página correspondiente. SipathnameSí/page1, entonces devuelvepage1el diseño de ; de lo contrario, devuelveindex_pageel diseño de .

Ejemplo completo

A continuación se muestra un ejemplo completo de diseño de múltiples páginas en Dash, que incluye una página de inicio, una página 'Acerca de' y una página 404.

Ejemplo

from dash import Dash, html, dcc, Input, Output

# Crear la aplicación Dash
app = Dash(__name__)

# Definir el diseño de la página de inicio
home_layout = html.Div([
    html.H1("Inicio"),
    html.P("¡Bienvenido a la página de inicio!"),
    dcc.Link('Ir a la página Acerca de', href='/about')
])

# Definir el diseño de la página Acerca de
about_layout = html.Div([
    html.H1("Acerca de"),
    html.P("Este es el contenido de la página Acerca de."),
    dcc.Link('Volver al inicio', href='/')
])

# Definir el diseño de la página 404
not_found_layout = html.Div([
    html.H1("404 - Página no encontrada"),
    html.P("La página que ha visitado no existe."),
    dcc.Link('Volver al inicio', href='/')
])

# Definir el diseño de la aplicación
app.layout = html.Div([
    dcc.Location(id='url', refresh=False),  # Para rastrear la URL
    html.Div(id='page-content')  # Para cargar dinámicamente el contenido de la página
])

# Definir la función de devolución de llamada
@app.callback(
    Output('page-content', 'children'),  # Salida al atributo children del Div con id 'page-content'
    Input('url', 'pathname')  # Entrada desde el atributo pathname del componente Location con id 'url'
)
def display_page(pathname):
    if pathname == '/':
        return home_layout  # Mostrar la página de inicio
    elif pathname == '/about':
        return about_layout  # Mostrar la página Acerca de
    else:
        return not_found_layout  # Mostrar la página 404

# Ejecutar la aplicación
if __name__ == '__main__':
    app.run_server(debug=True)

Después de ejecutar la aplicación, al visitarhttp://127.0.0.1:8050/se puede ver el contenido de la página de inicio; al hacer clic en"Ir a la página Acerca de"el enlace puede saltar a la página Acerca de; al hacer clic en"Volver al inicio"el enlace puede volver a la página de inicio.

Explicación del código

Diseño de la página:

  • home_layout: el diseño de la página de inicio, que incluye un título, una descripción y un enlace a la página Acerca de.

  • about_layout: el diseño de la página Acerca de, que incluye un título, una descripción y un enlace a la página de inicio.

  • not_found_layout: el diseño de la página 404, utilizado para manejar rutas que no existen.

dcc.Location:

  • id='url': se utiliza para rastrear la URL de la página actual.

  • refresh=False: deshabilita la recarga de la página, logrando el efecto de una aplicación de una sola página (SPA).

dcc.Link:

  • se utiliza para crear enlaces de navegación entre páginas,hrefla propiedad especifica la ruta de la página de destino.

La función de devolución de llamada:

  • segúnpathnameel valor de devuelve dinámicamente el diseño de página correspondiente.

  • Si la ruta es/, devuelvehome_layout。

  • Si la ruta es/about, devuelveabout_layout。

  • Si la ruta no coincide, devuelvenot_found_layout。


Ampliación

Para aplicaciones de múltiples páginas más complejas, se puede optimizar la estructura del código combinando los siguientes métodos:

1. Uso de diseño modular

Defina el diseño de cada página en un módulo separado para facilitar el mantenimiento y la ampliación.

Cree pages/home.py:

Ejemplo

from dash import html, dcc

layout = html.Div([
    html.H1("Inicio"),
    html.P("¡Bienvenido a la página de inicio!"),
    dcc.Link('Ir a la página Acerca de', href='/about')
])

Cree pages/about.py:

Ejemplo

from dash import html, dcc

layout = html.Div([
    html.H1("Acerca de"),
    html.P("Este es el contenido de la página Acerca de."),
    dcc.Link('Volver al inicio', href='/')
])

Importe los diseños en la aplicación principal:

from pages.home import layout as home_layout
from pages.about import layout as about_layout

2. Uso de parámetros de URL

Pase parámetros de URL a través de los atributos search o pathname de dcc.Location para implementar una lógica de página más flexible.

Ejemplo

@app.callback(
    Output('page-content', 'children'),
    Input('url', 'pathname')
)
def display_page(pathname):
    if pathname == '/':
        return home_layout
    elif pathname.startswith('/about'):
        # Analizar los parámetros de la URL
        return about_layout
    else:
        return not_found_layout
Otras ampliaciones