（数据科学学习手札104）Python+Dash快速web应用开发——回调交互篇（上）

本文示例代码已上传至个人Github仓库https://github.com/CNFeffery/DataScienceStudyNotes

1 简介

　　 这是个人系列教程Python+Dash快速web应用开发的第三期，在前两期的教程中，咱们围绕什么是Dash，以及如何配合方便好用的第三方拓展dash-bootstrap-components来为咱们的Dash应用设计布局展开了很是详细的介绍。

　　而Dash最吸引个人地方在于其高度封装了react.js，使得咱们无需编写js语句，纯Python编程就能够实现浏览器前端与后端计算之间常规的异步通讯，从而创造出功能强大的交互式web应用。

图1

　　从今天的文章开始，我就将开始带你们走进Dash的核心内容——回调。

2 Dash中的基础回调

2.1 最基础的回调

　　Dash中的回调（callback）是以装饰器的形式，配合自编回调函数，实现先后端异步通讯交互，这句话可能不太好理解，咱们从一个简单的例子出发来认识Dash中的回调：

app1.py

import dash
import dash_html_components as html
import dash_bootstrap_components as dbc
from dash.dependencies import Input, Output

app = dash.Dash(
    __name__,
    external_stylesheets=['css/bootstrap.min.css']
)

app.layout = html.Div(
    [
        html.Br(),
        html.Br(),
        html.Br(),
        dbc.Container(
            [
                dbc.Row(
                    [
                        dbc.Col(dbc.Input(id='input-value',
                                          placeholder='请输入些东西'),
                                width=12),
                        dbc.Col(dbc.Label(id='output-value'),
                                width=12)
                    ]
                )
            ]
        )
    ]
)


# 对应app实例的回调函数装饰器
@app.callback(
    Output('output-value', 'children'),
    Input('input-value', 'value')
)
def input_to_output(input_value):
    '''
    简单的回调函数
    '''
    return input_value


if __name__ == '__main__':
    app.run_server()

　　先来看看app1的交互效果：

图2

　　下面咱们来分解上面的代码，梳理一下要构造一个具备实际交互功能的Dash应用须要作什么：

• 肯定输入与输出部件

　　一个可交互的系统必定是有输入与输出的，咱们开头导入的Input与Output对象，他们分别扮演着输入者与输出者两种角色，其各自的第一个参数component_id用于联动前端部分定义的部件。

　　咱们在前面定义前端部件时，为dbc.Input对应的输入框设置了id='input-value'，为dbc.Label对应的文字输出设置了id='output-value'，让它们做为第一个参数能够被Input()与Output()惟一识别出来。

• 肯定输入与输出内容

　　在肯定了输入者与输出者以后，更重要的是为告诉Dash须要监听什么输入，响应什么输出，这就要用到第二个参数component_property。

　　它与对应的前端部件有关，譬如咱们的dbc.Input()输入框，其被输入的内容都存在value属性中，而children属性是dbc.Label以及绝大多数html部件的第一个参数，这样咱们就肯定了输入输出内容。

• 装饰回调函数

　　app.callback()装饰器按照规定的先Output()后Input()的顺序传入相应对象，而既然是装饰器，天然须要配合自定义回调函数使用。

　　咱们的input_to_output()就是对应的回调函数，其参数与装饰器中的Input()对应，而函数内部则用来定义计算处理过程。

　　最后return的对象则对应Output()。

# 对应app实例的回调函数装饰器
@app.callback(
    Output('output-value', 'children'),
    Input('input-value', 'value')
)
def input_to_output(input_value):
    '''
    简单的回调函数
    '''
    return input_value

　　经过上面这样的结构，咱们得以纯Python“寥寥数语”实现了交互功能，赋予咱们编写任意功能Dash应用的能力。

2.2 同时设置多个Input()与Output()

　　在上一小节中咱们介绍的是最基本的单输入 -> 单输出回调模式，不少时候咱们须要更复杂的回调模式，譬以下面的例子：

app2.py

import dash
import dash_html_components as html
import dash_bootstrap_components as dbc
from dash.dependencies import Input, Output

app = dash.Dash(
    __name__,
    external_stylesheets=['css/bootstrap.min.css']
)

app.layout = html.Div(
    [
        html.Br(),
        html.Br(),
        html.Br(),
        dbc.Container(
            [
                dbc.Row(
                    [
                        dbc.Col(dbc.Input(id='input-value1'), width=3),
                        dbc.Col(html.P('+'), width=1),
                        dbc.Col(dbc.Input(id='input-value2'), width=3),
                    ],
                    justify='start'
                ),
                html.Hr(),
                dbc.Label(id='output-value')
            ]
        )
    ]
)


@app.callback(
    Output('output-value', 'children'),
    Input('input-value1', 'value'),
    Input('input-value2', 'value')
)
def input_to_output(input_value1, input_value2):

    try:
        return float(input_value1) + float(input_value2)
    except:
        return '请输入合法参数！'


if __name__ == '__main__':
    app.run_server()

图3

　　这里咱们的Input()对象不止一个，在Output()对象以后依次传入（也能够把全部Input()对象包在一个列表中传入），其顺序对应后面回调函数的参数顺序，从而实现了多个输入值的一一对应。

　　一样的，Output()也能够有多个：

app3.py

import dash
import dash_html_components as html
import dash_bootstrap_components as dbc
from dash.dependencies import Input, Output

app = dash.Dash(
    __name__,
    external_stylesheets=['css/bootstrap.min.css']
)

app.layout = html.Div(
    [
        html.Br(),
        html.Br(),
        html.Br(),
        dbc.Container(
            [
                dbc.Row(
                    [
                        dbc.Col(dbc.Input(id='input-lastname'), width=3),
                        dbc.Col(html.P('+'), width=1),
                        dbc.Col(dbc.Input(id='input-firstname'), width=3),
                    ],
                    justify='start'
                ),
                html.Hr(),
                dbc.Label(id='output1'),
                html.Br(),
                dbc.Label(id='output2')
            ]
        )
    ]
)


@app.callback(
    [Output('output1', 'children'),
     Output('output2', 'children')],
    [Input('input-lastname', 'value'),
     Input('input-firstname', 'value')]
)
def input_to_output(lastname, firstname):

    try:
        return '完整姓名：' + lastname + firstname, f'姓名长度为{len(lastname+firstname)}'
    except:
        return '等待输入...', '等待输入...'


if __name__ == '__main__':
    app.run_server()

图4

　　能够看到无论是多个Output()仍是Input()，只须要嵌套在列表中便可。

2.3 利用State()实现惰性交互

　　不少状况下，若是咱们的回调函数计算过程时间开销较大，那么像前面介绍的仅靠Input()与Output()实现的先后端通讯会很频繁，由于监听到的全部输入部件对应属性值只要略一改变，就会触发回调。

　　为了解决这类问题，Dash中设计了State()对象，咱们能够利用State()替换Input()来绑定对应的输入值，再将一些须要主动触发的譬如dbc.Button()按钮部件的属性n_clicks，做为Input()对象进行绑定。

　　让咱们经过下面的例子更好的理解它的做用：

app4.py

import dash
import dash_html_components as html
import dash_bootstrap_components as dbc
from dash.dependencies import Input, Output, State

app = dash.Dash(
    __name__,
    external_stylesheets=['css/bootstrap.min.css']
)

app.layout = html.Div(
    [
        html.Br(),
        html.Br(),
        html.Br(),
        dbc.Container(
            [
                dbc.Row(
                    [
                        dbc.Col(dbc.Input(id='input-value'),
                                width=4),
                        dbc.Col(dbc.Button('小写转大写',
                                           id='state-button',
                                           n_clicks=0),
                                width=4),
                        dbc.Col(dbc.Label(id='output-value',
                                          style={'padding': '0',
                                                 'margin': '0',
                                                  'line-height': '38px'}),
                                width=4)
                    ],
                    justify='start'
                )
            ]
        )
    ]
)


@app.callback(
    Output('output-value', 'children'),
    Input('state-button', 'n_clicks'),
    State('input-value', 'value')

)
def input_to_output(n_clicks, value):

    if n_clicks:
        return value.upper()


if __name__ == '__main__':
    app.run_server()

图5

　　能够看到，装饰器中按照Output()、Input()、State()的顺序传入各个对象后，咱们的Button()部件的n_clicks参数记录了对应的按钮被点击了多少次，初始化咱们设置其为0，以后每次等咱们输入完单词，主动去点击按钮从而增长其被点击次数记录时，回调函数才会被触发，这样就方便了咱们的不少复杂应用场景~

---

　　以上就是本期的所有内容，欢迎在评论区与我进行讨论~