Dash 2.15版本新特性介绍
本文示例代码已上传至我的
Github
仓库https://github.com/CNFeffery/dash-master
大家好我是费老师,Dash
不久前发布了其2.15.0
版本,新增了一些实用的特性,下面我们就来一起get其中的重点😉:
1 在浏览器端回调中获知触发来源
熟悉Dash
应用开发的朋友应该知道,针对编排了多个Input
角色的常规回调函数,我们可以通过dash.ctx.triggered_id
等上下文信息,在每次回调函数被触发时,知晓究竟是哪个Input
角色触发了本次的回调函数执行,就像下面这个简单的例子所展示的那样:
app1.py
import dash
from dash import html
import feffery_antd_components as fac
from dash.dependencies import Input, Output
app = dash.Dash(__name__)
app.layout = html.Div(
[
fac.AntdSpace(
[
fac.AntdButton(
'按钮1',
id='button1',
type='primary'
),
fac.AntdButton(
'按钮2',
id='button2',
type='primary'
)
]
),
fac.AntdParagraph(id='demo-output')
],
style={
'padding': 50
}
)
@app.callback(
Output('demo-output', 'children'),
[Input('button1', 'nClicks'),
Input('button2', 'nClicks')],
prevent_initial_call=True
)
def handle_button_click(nClicks1, nClicks2):
return '本次回调触发来源:{}'.format(
dash.ctx.triggered_id
)
if __name__ == '__main__':
app.run(debug=True)
而从2.15.0
版本开始,浏览器端回调中同样也支持在回调函数中拿到triggered_id
信息,在上面例子的基础上,我们将常规回调函数改造为下面的浏览器端回调函数,来看看dash_clientside.callback_context
中包含了哪些信息:
app.clientside_callback(
'''(nClicks1, nClicks2) => {
// 打印本次回调上下文信息
console.log(dash_clientside.callback_context)
}''',
Output('demo-output', 'children'),
[Input('button1', 'nClicks'),
Input('button2', 'nClicks')],
prevent_initial_call=True
)
Dash < 2.15.0
Dash >= 2.15.0
可以看到,在新版本中,浏览器端回调中的回调上下文信息新增了triggered_id
信息,更加方便了~
2 调试模式下更方便清晰的错误提示
另一项重要的新特性是面向像费老师我这样的Dash
组件库开发者的,可以在组件底层自定义需要在Dash
的debug
工具页面中显示的错误提示信息,从而大幅度提升普通Dash
应用开发者的日常体验😉~
以由我开源维护的网页通用组件库fac
中的进度条组件AntdProgress
为例(https://fac.feffery.tech/AntdProgress
),其percent
参数用于设置进度值,取值应在0到1之间:
得益于新版本Dash
在底层对于自定义错误提示的支持,我就可以在AntdProgress
底层对不符合规范要求的参数值进行检查,并通过Dash
调试模式自带的前端控件输出更清晰的错误提示(下面的例子仅做简单演示,我会在由我维护的一系列Dash
组件库后续的版本升级中逐步形成更清晰完整的错误提示体系):
更多有关2.15.0
版本更新内容的信息请移步https://github.com/plotly/dash/releases/tag/v2.15.0
。
以上就是本文的全部内容,对Dash
应用开发感兴趣的朋友,欢迎添加微信号CNFeffery
,备注“dash学习”加入我的技术交流群,一起成长一起进步。