← 全部模板

请求与响应 <RequestResponse />

左右两个代码窗:左边是发出的请求,右边是返回的响应,中间一条带标签的箭头,上面有光点从左跑到右。

在示例演示里查看 →

分组
技术 · 一次往返
组件
RequestResponse · #request-response
交互
箭头和响应是一个 build 步骤;光点动画在减少动态效果和打印时关闭

适合

  • 讲一次 API 调用、SQL 语句和返回、协议往返
  • 请求和响应都能用几行文本表示

不适合

  • 有多次往返或多方参与:用 SessionSequence
  • 只有命令和输出、没有“两端”之分:用 Terminal

内容上限

1label ≤ 10 字;file ≤ 20 个字符
2lines 2–9 行,每行 ≤ 36 个字符
3via ≤ 8 字
4note ≤ 50 字

字段

字段类型
kicker · 必填string标题上方的小节名,2–8 字
title · 必填string | string[]页面标题;传数组可手动断行,每项一行
leadstring一到两句导语,≤ 60 字
sourcestring事实出处;页面上有任何数据或事实时必填
hintReactNode页眉中间的操作提示,可用 <kbd>
request · 必填{ label, file?, lines }请求
response · 必填{ label, file?, lines }响应
viastring箭头下的标签
notestring下方的一句解读

示例代码

<RequestResponse kicker="一次往返" title="…" request={{ label: '客户端发送', lines: ['UPDATE …'] }} via="一次往返" response={{ label: '服务器返回', lines: ['UPDATE 1'] }} />