Общие интерактивные компоненты Dash

Dash основан на Python и позволяет разработчикам создавать интерактивные веб-приложения, используя чистый код Python.

Один из основных компонентов Dash — этоdash.dcc(Dash Core Components), который предоставляет расширенные компоненты пользовательского интерфейса, такие как ползунки, выпадающие меню, графики и т. д. Эти компоненты помогают разработчикам быстро создавать мощные веб-приложения.

dash.dccКомпоненты включают, но не ограничиваются:

  • Graph: Используется для построения различных графиков, таких как линейные графики, столбчатые диаграммы, диаграммы рассеяния и т. д.
  • Dropdown: Выпадающее меню, позволяющее пользователям выбрать один вариант из нескольких.
  • Slider: Ползунок, позволяющий пользователям выбрать числовой диапазон перетаскиванием.
  • Input: Поле ввода, позволяющее пользователям вводить текст или числа.
  • Textarea: Многострочное поле ввода текста, подходящее для ввода более длинного текстового содержимого.
  • Checklist: Список флажков, позволяющий пользователям выбрать несколько вариантов.
  • RadioItems: Список переключателей, позволяющий пользователям выбрать один вариант из нескольких.
  • DatePickerSingleиDatePickerRange: Выбор даты, позволяющий пользователям выбрать одну дату или диапазон дат.
  • Upload: Компонент загрузки файлов, позволяющий пользователям загружать файлы.

Эти компоненты — основа для создания интерактивных веб-приложений. Разработчики могут создавать сложные пользовательские интерфейсы, комбинируя эти компоненты.

В последней версии Dash рекомендуется импортировать dcc следующим образом:

from dash import dcc

Общие интерактивные компоненты → Общие интерактивные компоненты

Компоненты Описание Пример кода
dcc.Input Создайте поле ввода текста. dcc.Input(id='input', type='text', placeholder='请输入内容...')
dcc.Dropdown Создайте выпадающее меню. dcc.Dropdown(id='dropdown', options=[{'label': '选项1', 'value': '1'}], value='1')
dcc.Slider Создайте ползунок. dcc.Slider(id='slider', min=0, max=10, step=1, value=5)
dcc.Graph Создайте интерактивный график (на основе Plotly.js). dcc.Graph(id='graph', figure={'data': [{'x': [1, 2, 3], 'y': [4, 1, 2], 'type': 'bar'}]})
dcc.Textarea Создайте многострочное поле ввода текста. dcc.Textarea(id='textarea', value='请输入多行文本...')
dcc.Checklist Создайте список флажков. dcc.Checklist(id='checklist', options=[{'label': '选项1', 'value': '1'}], value=['1'])
dcc.RadioItems Создайте группу переключателей. dcc.RadioItems(id='radio', options=[{'label': '选项1', 'value': '1'}], value='1')
dcc.DatePickerSingle Создайте средство выбора даты (одиночной). dcc.DatePickerSingle(id='date-picker', date='2023-10-01')
dcc.DatePickerRange Создайте средство выбора диапазона дат. dcc.DatePickerRange(id='date-range', start_date='2023-10-01', end_date='2023-10-07')
dcc.Markdown Отобразите текст Markdown. dcc.Markdown('''# 标题\n- 列表项1''')
dcc.Store Сохраняйте данные на стороне клиента для обмена данными между колбэками. dcc.Store(id='store', data={'key': 'value'})
dcc.Upload Создайте компонент загрузки файлов. dcc.Upload(id='upload', children=html.Div('拖放或点击上传文件'))
dcc.Tabs Создайте компонент вкладок. dcc.Tabs(id='tabs', children=[dcc.Tab(label='标签1', value='1')])
dcc.Tab Создайте отдельную вкладку (должна использоваться вместе сdcc.TabsИспользуйте вместе с). dcc.Tab(label='标签1', value='1')
dcc.Interval Компонент, который периодически запускает обратные вызовы. dcc.Interval(id='interval', interval=1000)
dcc.Location Компонент для управления URL. dcc.Location(id='url', pathname='/')
dcc.Link Создайте гиперссылку для навигации по страницам (должна использоваться вместе сdcc.LocationИспользуйте вместе с). dcc.Link('跳转到首页', href='/index.html')
dcc.ConfirmDialog Создайте диалоговое окно подтверждения. dcc.ConfirmDialog(id='confirm', message='确定要执行此操作吗?')
dcc.ConfirmDialogProvider Предоставьте диалоговое окно подтверждения (необходимо использовать вместе с такими компонентами, как кнопки). dcc.ConfirmDialogProvider(html.Button('删除'), id='confirm-provider')
dcc.Loading Создайте компонент анимации загрузки. dcc.Loading(id='loading', children=[html.Div('加载中...')])
dcc.Download Компонент, используемый для запуска загрузки файлов. dcc.Download(id='download')

Пример приложения

Создайте простое приложение Dash

Ниже приведён пример простого приложения Dash, демонстрирующий, как использоватьdash.dccКомпонент:

Пример

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

# Создайте приложение Dash
app = dash.Dash(__name__)

# Определить макет приложения
app.layout = html.Div([
    dcc.Input(id='input-text', type='text', value=''),
    html.Div(id='output-text')
])

# Определить функцию обратного вызова
@app.callback(
    Output('output-text', 'children'),
    [Input('input-text', 'value')]
)
def update_output(value):
    return f'Введённое вами содержимое: {value}'

# Запустить приложение
if __name__ == '__main__':
    app.run_server(debug=True)

В приведённом выше примере мы создали простое приложение Dash, содержащее поле ввода и область, отображающую введённое содержимое.

Когда пользователь вводит содержимое в поле ввода, приложение обновляет содержимое области отображения в реальном времени.

Использованиеdcc.GraphПостроить график

dcc.GraphДаdash.dccодин из наиболее часто используемых компонентов, используемый для построения различных графиков.

Далее areaUsage → Ниже приведён пример использованияdcc.GraphПример построения линейного графика:

Пример

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

# Создайте приложение Dash
app = dash.Dash(__name__)

# Создание тестовых данных
df = pd.DataFrame({
    'x': [1, 2, 3, 4, 5],
    'y': [10, 11, 12, 13, 14]
})

# Создание линейного графика с помощью Plotly Express
fig = px.line(df, x='x', y='y', title='Пример линейного графика')

# Определить макет приложения
app.layout = html.Div([
    dcc.Graph(figure=fig)
])

# Запустить приложение
if __name__ == '__main__':
    app.run_server(debug=True)

В приведённом выше примере мы используемplotly.expressСоздали простой линейный график и передали его черезdcc.GraphКомпонент отображает его в приложении.

Использованиеdcc.DropdownСоздать выпадающее меню → Создать выпадающее меню

dcc.Dropdownкомпонент позволяет пользователям выбрать один из нескольких вариантов.

Далее areaUsage → Ниже приведён пример использованияdcc.Dropdownпример:

Пример

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

# Создайте приложение Dash
app = dash.Dash(__name__)

# Определить макет приложения
app.layout = html.Div([
    dcc.Dropdown(
        id='dropdown',
        options=[
            {'label': 'Вариант 1', 'value': '1'},
            {'label': 'Вариант 2', 'value': '2'},
            {'label': 'Вариант 3', 'value': '3'}
        ],
        value='1'  # Значение, выбранное по умолчанию
    ),
    html.Div(id='dropdown-output')
])

# Определить функцию обратного вызова
@app.callback(
    Output('dropdown-output', 'children'),
    [Input('dropdown', 'value')]
)
def update_output(value):
    return f'Вы выбрали: {value}'

# Запустить приложение
if __name__ == '__main__':
    app.run_server(debug=True)

В приведённом выше примере мы создали выпадающее меню. Когда пользователь выбирает опцию, приложение отображает содержимое, выбранное пользователем.


dash.dccОбщие свойства и обратные вызовы компонентов

dash.dccСвойства компонента очень разнообразны, и каждый компонент имеет свои специфические свойства.

Ниже приведены свойства некоторых распространённых компонентов:

  • dcc.Input:

    • id: Уникальный идентификатор компонента.
    • type: типы ввода, такие как → : типы ввода, такие какtext、numberи т. д.
    • value: Текущее значение поля ввода.
  • dcc.Dropdown:

    • id: Уникальный идентификатор компонента.
    • options: Список опций выпадающего меню, каждая опция — это словарь, содержащийlabelиvalue。
    • value: Текущее выбранное значение.
  • dcc.Graph:

    • id: Уникальный идентификатор компонента.
    • figure: Объект диаграммы для отображения, обычно создаваемый с помощьюplotly.expressилиplotly.graph_objectsCreate.
  • dcc.Slider:

    • id: Уникальный идентификатор компонента.
    • min: Минимальное значение ползунка.
    • max: Максимальное значение ползунка.
    • value: Текущее значение ползунка.

функция обратного вызова

В Dash функции обратного вызова используются для обработки взаимодействий пользователя. Функции обратного вызова определяются с помощью@app.callbackдекоратора и указывают входные и выходные компоненты.

Ниже приведён простой пример функции обратного вызова:

Пример

@app.callback(
    Output('output-component', 'children'),
    [Input('input-component', 'value')]
)
def update_output(value):
    return f'Введённое вами содержимое: {value}'

withTopin в примере, функция обратного вызова → В приведённом выше примере функция обратного вызоваupdate_outputбудетinput-componentвызывается, когда значение изменяется, и новое значение передаётся вoutput-component。


Практические примеры применения

dash.dccКомпоненты имеют широкий спектр применения в реальных проектах. Ниже приведён пример реального применения, показывающий, как использоватьdash.dccкомпонент для создания интерактивного приложения визуализации данных.

Интерактивное приложение визуализации данных

Предположим, у нас есть набор данных, содержащий данные о температуре и влажности для разных городов. Мы можем использоватьdash.dccкомпонент для создания интерактивного приложения, которое позволяет пользователям выбирать город и просматривать соответствующие графики температуры и влажности.

Пример

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

# Создайте приложение Dash
app = dash.Dash(__name__)

# Создание тестовых данных
df = pd.DataFrame({
    'city': ['Пекин', 'Шанхай', 'Гуанчжоу', 'Shenzhen'],
    'Temperature': [20, 25, 30, 28],
    'Humidity': [50, 60, 70, 65]
})

# Определить макет приложения
app.layout = html.Div([
    dcc.Dropdown(
        id='city-dropdown',
        options=[{'label': city, 'value': city} for city in df['city']],
        value='Beijing'  # Город по умолчанию
    ),
    dcc.Graph(id='temperature-graph'),
    dcc.Graph(id='humidity-graph')
])

# Определить функцию обратного вызова
@app.callback(
    [Output('temperature-graph', 'figure'),
     Output('humidity-graph', 'figure')],
    [Input('city-dropdown', 'value')]
)
def update_graphs(selected_city):
    filtered_df = df[df['city'] == selected_city]
    temperature_fig = px.bar(filtered_df, x='city', y='Temperature', title='Temperature')
    humidity_fig = px.bar(filtered_df, x='city', y='Humidity', title='Humidity')
    return temperature_fig, humidity_fig

# Запустить приложение
if __name__ == '__main__':
    app.run_server(debug=True)

В приведенном выше примере пользователь может выбрать город через выпадающее меню, и приложение обновит столбчатую диаграмму температуры и влажности в соответствии с выбором пользователя.

Другие расширения