Dash Componentes de interacción comunes

Dash se basa en Python y permite a los desarrolladores crear aplicaciones web interactivas con código Python puro.

Uno de los componentes centrales de Dash esdash.dcc(Dash Core Components), que ofrece una amplia variedad de componentes de interfaz de usuario, como controles deslizantes, menús desplegables, gráficos, etc. Estos componentes ayudan a los desarrolladores a crear rápidamente aplicaciones web potentes.

dash.dccLos componentes incluyen, entre otros:

  • Graph: se utiliza para dibujar varios gráficos, como gráficos de líneas, gráficos de barras, gráficos de dispersión, etc.
  • Dropdown: menú desplegable que permite al usuario seleccionar una de varias opciones.
  • Slider: control deslizante que permite al usuario seleccionar un rango numérico arrastrando el control.
  • Input: campo de entrada que permite al usuario introducir texto o números.
  • Textarea: campo de texto multilínea, adecuado para introducir contenido de texto más largo.
  • Checklist: lista de casillas de verificación que permite al usuario seleccionar varias opciones.
  • RadioItems: lista de botones de opción que permite al usuario seleccionar una de varias opciones.
  • DatePickerSingleyDatePickerRange: selector de fecha que permite al usuario seleccionar una fecha única o un rango de fechas.
  • Upload: componente de carga de archivos que permite al usuario subir archivos.

Estos componentes son la base para construir aplicaciones web interactivas. Los desarrolladores pueden crear interfaces de usuario complejas combinando estos componentes.

En la última versión de Dash, se recomienda importar dcc de la siguiente manera:

from dash import dcc

Componentes de interacción comunes

Componente Descripción Código de ejemplo
dcc.Input Crea un campo de entrada de texto. dcc.Input(id='input', type='text', placeholder='请输入内容...')
dcc.Dropdown Crea un menú desplegable. dcc.Dropdown(id='dropdown', options=[{'label': '选项1', 'value': '1'}], value='1')
dcc.Slider Crea un control deslizante. dcc.Slider(id='slider', min=0, max=10, step=1, value=5)
dcc.Graph Crea un gráfico interactivo (basado en Plotly.js). dcc.Graph(id='graph', figure={'data': [{'x': [1, 2, 3], 'y': [4, 1, 2], 'type': 'bar'}]})
dcc.Textarea Crea un campo de texto multilínea. dcc.Textarea(id='textarea', value='请输入多行文本...')
dcc.Checklist Crea una lista de casillas de verificación. dcc.Checklist(id='checklist', options=[{'label': '选项1', 'value': '1'}], value=['1'])
dcc.RadioItems Crea un grupo de botones de opción. dcc.RadioItems(id='radio', options=[{'label': '选项1', 'value': '1'}], value='1')
dcc.DatePickerSingle Crea un selector de fecha (selección única). dcc.DatePickerSingle(id='date-picker', date='2023-10-01')
dcc.DatePickerRange Crea un selector de rango de fechas. dcc.DatePickerRange(id='date-range', start_date='2023-10-01', end_date='2023-10-07')
dcc.Markdown Representa texto Markdown. dcc.Markdown('''# 标题\n- 列表项1''')
dcc.Store Almacena datos en el cliente para compartir datos entre devoluciones de llamada. dcc.Store(id='store', data={'key': 'value'})
dcc.Upload Crea un componente de carga de archivos. dcc.Upload(id='upload', children=html.Div('拖放或点击上传文件'))
dcc.Tabs Crea un componente de pestañas. dcc.Tabs(id='tabs', children=[dcc.Tab(label='标签1', value='1')])
dcc.Tab Crea una pestaña individual (debe usarsedcc.Tabsen combinación). dcc.Tab(label='标签1', value='1')
dcc.Interval Componente que activa devoluciones de llamada periódicamente. dcc.Interval(id='interval', interval=1000)
dcc.Location Componente para gestionar la URL. dcc.Location(id='url', pathname='/')
dcc.Link Crea un hipervínculo para la navegación de páginas (debe usarsedcc.Locationen combinación). dcc.Link('跳转到首页', href='/index.html')
dcc.ConfirmDialog Crea un cuadro de diálogo de confirmación. dcc.ConfirmDialog(id='confirm', message='确定要执行此操作吗?')
dcc.ConfirmDialogProvider Proporciona un cuadro de diálogo de confirmación (debe usarse en combinación con componentes como botones). dcc.ConfirmDialogProvider(html.Button('删除'), id='confirm-provider')
dcc.Loading Crea un componente de animación de carga. dcc.Loading(id='loading', children=[html.Div('加载中...')])
dcc.Download Componente para activar la descarga de archivos. dcc.Download(id='download')

Ejemplo de aplicación

Crear una aplicación Dash simple

A continuación se muestra un ejemplo de una aplicación Dash simple que muestra cómo usardash.dcclos componentes:

Ejemplo

import dash
from dash import dcc, html
from dash.dependencies import Input, Output

# Crear una aplicación Dash
app = dash.Dash(__name__)

# Definir el diseño de la aplicación
app.layout = html.Div([
    dcc.Input(id='input-text', type='text', value=''),
    html.Div(id='output-text')
])

# Definir la función de devolución de llamada
@app.callback(
    Output('output-text', 'children'),
    [Input('input-text', 'value')]
)
def update_output(value):
    return f'El contenido que has introducido es: {value}'

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

En el ejemplo anterior, creamos una aplicación Dash simple que contiene un campo de entrada y un área que muestra el contenido introducido.

Cuando el usuario introduce contenido en el campo de entrada, la aplicación actualiza en tiempo real el contenido del área de visualización.

Usodcc.GraphDibujar gráficos

dcc.GraphSídash.dcces uno de los componentes más utilizados, utilizado para dibujar varios gráficos.

A continuación se muestra un ejemplodcc.Graphde dibujo de un gráfico de líneas:

Ejemplo

import dash
from dash import dcc, html
import plotly.express as px
import pandas as pd

# Crear una aplicación Dash
app = dash.Dash(__name__)

# Crear datos de ejemplo
df = pd.DataFrame({
    'x': [1, 2, 3, 4, 5],
    'y': [10, 11, 12, 13, 14]
})

# Usar Plotly Express para crear un gráfico de líneas
fig = px.line(df, x='x', y='y', title='Gráfico de líneas de ejemplo')

# Definir el diseño de la aplicación
app.layout = html.Div([
    dcc.Graph(figure=fig)
])

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

En el ejemplo anterior, usamosplotly.expresspara crear un gráfico de líneas simple y, mediante eldcc.Graphcomponente, lo mostramos en la aplicación.

Usodcc.DropdownCrear un menú desplegable

dcc.DropdownEl componente permite al usuario seleccionar una de varias opciones.

A continuación se muestra un ejemplodcc.Dropdownde su uso:

Ejemplo

import dash
from dash import dcc, html
from dash.dependencies import Input, Output

# Crear una aplicación Dash
app = dash.Dash(__name__)

# Definir el diseño de la aplicación
app.layout = html.Div([
    dcc.Dropdown(
        id='dropdown',
        options=[
            {'label': 'Opción 1', 'value': '1'},
            {'label': 'Opción 2', 'value': '2'},
            {'label': 'Opción 3', 'value': '3'}
        ],
        value='1'  # Valor seleccionado por defecto
    ),
    html.Div(id='dropdown-output')
])

# Definir la función de devolución de llamada
@app.callback(
    Output('dropdown-output', 'children'),
    [Input('dropdown', 'value')]
)
def update_output(value):
    return f'Has seleccionado: {value}'

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

En el ejemplo anterior, creamos un menú desplegable. Cuando el usuario selecciona una opción, la aplicación muestra el contenido seleccionado por el usuario.


dash.dccPropiedades comunes y devoluciones de llamada de los componentes

dash.dccLas propiedades de los componentes son muy amplias; cada componente tiene sus propias propiedades específicas.

A continuación se muestran algunas propiedades de componentes comunes:

  • dcc.Input:

    • id: identificador único del componente.
    • type: tipo de entrada, comotext、numberetc.
    • value: valor actual del campo de entrada.
  • dcc.Dropdown:

    • id: identificador único del componente.
    • options: lista de opciones del menú desplegable; cada opción es un diccionario que contienelabelyvalue。
    • value: valor actualmente seleccionado.
  • dcc.Graph:

    • id: identificador único del componente.
    • figure: objeto de gráfico a mostrar, normalmenteplotly.expressoplotly.graph_objectscreado por.
  • dcc.Slider:

    • id: identificador único del componente.
    • min: valor mínimo del control deslizante.
    • max: valor máximo del control deslizante.
    • value: valor actual del control deslizante.

Función de devolución de llamada

En Dash, las funciones de devolución de llamada se utilizan para manejar las interacciones del usuario. Las funciones de devolución de llamada se definen mediante el@app.callbackdecorador y especifican los componentes de entrada y salida.

A continuación se muestra un ejemplo de una función de devolución de llamada simple:

Ejemplo

@app.callback(
    Output('output-component', 'children'),
    [Input('input-component', 'value')]
)
def update_output(value):
    return f'El contenido que has introducido es: {value}'

En el ejemplo anterior, la función de devolución de llamadaupdate_outputse llamará cuandoinput-componentel valor de cambie, y pasará el nuevo valor aoutput-component。


Caso de aplicación real

dash.dccLos componentes tienen una amplia aplicación en proyectos reales. A continuación se muestra un caso de aplicación real que demuestra cómo usardash.dcclos componentes para construir una aplicación interactiva de visualización de datos.

Aplicación interactiva de visualización de datos

Supongamos que tenemos un conjunto de datos con datos de temperatura y humedad de diferentes ciudades. Podemos usardash.dcclos componentes para construir una aplicación interactiva que permita al usuario seleccionar una ciudad y ver los gráficos de temperatura y humedad correspondientes.

Ejemplo

import dash
from dash import dcc, html
from dash.dependencies import Input, Output
import plotly.express as px
import pandas as pd

# Crear una aplicación Dash
app = dash.Dash(__name__)

# Crear datos de ejemplo
df = pd.DataFrame({
    'Ciudad': ['Pekín', 'Shanghái', 'Cantón', 'Shenzhen'],
    'Temperatura': [20, 25, 30, 28],
    'Humedad': [50, 60, 70, 65]
})

# Definir el diseño de la aplicación
app.layout = html.Div([
    dcc.Dropdown(
        id='city-dropdown',
        options=[{'label': city, 'value': city} for city in df['Ciudad']],
        value='Pekín'  # Ciudad seleccionada por defecto
    ),
    dcc.Graph(id='temperature-graph'),
    dcc.Graph(id='humidity-graph')
])

# Definir la función de devolución de llamada
@app.callback(
    [Output('temperature-graph', 'figure'),
     Output('humidity-graph', 'figure')],
    [Input('city-dropdown', 'value')]
)
def update_graphs(selected_city):
    filtered_df = df[df['Ciudad'] == selected_city]
    temperature_fig = px.bar(filtered_df, x='Ciudad', y='Temperatura', title='Temperatura')
    humidity_fig = px.bar(filtered_df, x='Ciudad', y='Humedad', title='Humedad')
    return temperature_fig, humidity_fig

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

En el ejemplo anterior, el usuario puede seleccionar una ciudad a través del menú desplegable, y la aplicación actualiza los gráficos de barras de temperatura y humedad según la selección del usuario.

Otras extensiones