跳到主要内容
版本:0.4.2

搜索和选择数据

接下来的指南展示了DashJsonGrid的交互功能。这些交互允许透过搜索关键字高亮数据,以及获取当前被用户选中的数据。

为了节约篇幅,本章所用的范例中,都将数据预设为了以下值:

data.py
test_data = {
"id": "0001",
"type": "donut",
"name": "Cake",
"ppu": 1111.55,
"batters": {
"batter": [
{"id": "1001", "type": "Regular"},
{"id": "1002", "type": "Chocolate"},
{"id": "1003", "type": "Blueberry"},
{"id": "1004", "type": "Devil's Food"},
]
},
"topping": [
{"id": "5001", "type": "None"},
{"id": "5002", "type": "Glazed"},
{"id": "5005", "type": "Sugar"},
{"id": "5007", "type": "Powdered Sugar"},
{"id": "5006", "type": "Chocolate with Sprinkles"},
{"id": "5003", "type": "Chocolate"},
{"id": "5004", "type": "Maple"},
],
}

搜索并高亮数据

下例透过dcc.Input组件、设置了查询关键字、以搜索数据。所有搜索到的结果,都会高亮为特殊的样式。

该实现基于普通的callback。

search_and_highlight.py
import dash
from dash import dcc, html
from dash import Output, Input
import dash_json_grid as djg
from data import test_data


app = dash.Dash("demo")
app.layout = html.Div(
children=(
dcc.Input(id="search", type="text", value=None),
djg.DashJsonGrid(
id="grid", data=test_data, search_text=None, default_expand_depth=2
),
)
)


@app.callback(Output("grid", "search_text"), Input("search", "value"))
def update_search(value):
if not value:
return None
return value


if __name__ == "__main__":
app.run()
提示

本章的范例中,都添加了参数default_expand_depth=2。该参数令嵌套数据、在没有用户交互的默认情况下,渲染为展开到第二级。详情请参详DashJsonGrid

信息

search_text是“仅可设置(set-only)”属性。这指的是,该属性只能被callback重新设置。组件本身无论如何都不会发起以该值为输入的callback。换言之,search_text仅能通过代码修改,不可被用户交互改变。

控制组件的单击选择数据功能

可以通过属性控制组件、决定用户是否可以选中渲染出的数据。如果“可选择(selectable)”功能关闭,即使用户单击数据,数据也不会被选中。自然,这种情况下也不会发出任何callback。

该实现基于普通的callback。

selectable.py
import dash
from dash import dcc, html
from dash import Output, Input
import dash_json_grid as djg
from data import test_data


app = dash.Dash("demo")
app.layout = html.Div(
children=(
dcc.Checklist(id="check", options=["Selectable"], value=["Selectable"]),
djg.DashJsonGrid(
id="grid", data=test_data, highlight_selected=True, default_expand_depth=2
),
)
)


@app.callback(
Output("grid", "highlight_selected"), Input("check", "value")
)
def is_highlighted(val):
return isinstance(val, (list, tuple)) and "Selectable" in val


if __name__ == "__main__":
app.run()
信息

highlight_selected是“仅可设置(set-only)”属性。这指的是,该属性只能被callback重新设置。组件本身无论如何都不会发起以该值为输入的callback。换言之,highlight_selected仅能通过代码修改,不可被用户交互改变。

捕获选中的数据

可以透过callback捕获选中的值。每当有数据被选中时,组件属性selected_path都会发起一次callback。该属性用来标识当前被选中的值、在整个数据中的访问路径。用户可以定义callback来处理该值。

该实现基于普通的callback。

catch_selected.py
import json
import dash
from dash import dcc, html
from dash import Output, Input
import dash_json_grid as djg
from data import test_data


app = dash.Dash("demo")
app.layout = html.Div(
children=(
djg.DashJsonGrid(id="grid", data=test_data, default_expand_depth=2),
html.P(id="selected-path", children=None),
)
)


@app.callback(Output("selected-path", "children"), Input("grid", "selected_path"))
def forward_selected_path(val):
return json.dumps(val)


if __name__ == "__main__":
app.run()
信息

selected_path是“仅可交互(interact-only)”属性。这指的是,该属性只能透过用户交互触发callback。相比之下,用形如Output("grid", "selected_path")的方法,透过callback更新该数据,将不会产生任何效果,亦即、不会改变被选中的数据。为了规避这种预期外的情况,用户不应透过dash.Output来修改selected_path