交互与用户体验 / 系统课时
呈现长答案中的代码与表格
呈现长答案中的代码与表格
当 AI 一次返回结论、操作步骤、代码和数据表时,读者需要先扫读,再定位证据、复制代码或比较数字。本篇以一条订单分析回答为样本,制定可落地的排版、滚动、复制和折叠规则,并用桌面与手机两种宽度验证效果。
学习目标
- 为标题、列表、长段落建立可扫描的阅读层级。
- 明确代码块与表格的复制、横向溢出和折叠规则。
- 使用固定样本检查窄屏阅读、键盘操作与内容完整性。
用一条长答案确定阅读层级
设计测试样本时,不要只放三行演示文字。准备一条包含「结论摘要、两个小标题、四步列表、400 字说明、48 行代码、六列表格」的回答,才能暴露真实的阅读问题。回答正文沿用语义标题,不把所有内容塞进同一个段落;列表每项只表达一个操作,代码和表格各自占独立容器。
以下尺寸是一套可直接用于原型验收的设计基线,而非所有设备的强制标准:
| 元素 | 桌面与移动端建议值 | 检查重点 |
|---|---|---|
| 回答内容列 | 桌面最大 760 px;390 px 手机两侧各留 16 px | 手机可用宽度为 358 px |
| 正文 | 16 px,行高 26 px | 长段落按语义分段 |
| 二级/三级标题 | 20/17 px,标题上间距 24 px | 层级不能只靠加粗 |
| 列表 | 条目间距 8 px,缩进 24 px | 序号与正文对齐 |
| 代码 | 等宽 14 px,行高 22 px,内边距 16 px | 保留缩进和换行 |
对很长的说明段,按「结论→依据→限制」拆成每段约 80~150 个汉字;不要强行在字符串中插入硬换行,屏幕宽度变化时由排版系统自然折行。
让代码可以识别、完整复制和局部滚动
代码容器顶部显示语言标签(如 Python)与「复制代码」按钮。复制内容只包含原始代码,不包含语言标签、行号、折叠提示或回答中的解释文字。缺失语言信息时显示「代码」,不要根据内容猜测并高亮成另一种语言;语法高亮不能成为区分错误与正确的唯一线索。
下面是用于验收的 Python 3 代码块;按钮应复制全部四行,保留缩进与换行:
orders = {"自然搜索": 128, "广告投放": 92}
# 输出各渠道的已支付订单数,供核对复制结果。
for channel, count in orders.items():
print(f"{channel}:{count} 单")预期输出:
自然搜索:128 单
广告投放:92 单代码窄屏默认保留缩进和原始换行。当单行宽度超过容器时,仅代码区横向滚动,消息气泡和整个页面不应横移。可提供「自动换行」开关,但切换仅改变视觉排版,不改变复制的源码。复制按钮点击热区建议至少 44×44 px,成功后短暂提示「已复制」,失败时保留原代码并提示重试。
表格保持列对应关系,而不是挤成小字
以下为界面样本数据。订单数是整数、金额按元显示、比率保留一位小数;数值列右对齐,文本列左对齐,表头说明单位。
| 渠道 | 已支付订单 | GMV(元) | 退款率 | 转化率 | 数据截止 |
|---|---|---|---|---|---|
| 自然搜索 | 128 | 32,600 | 2.3% | 4.8% | 10 月 7 日 |
| 广告投放 | 92 | 25,400 | 3.1% | 3.2% | 10 月 7 日 |
| 直接访问 | 61 | 13,200 | 1.6% | 5.1% | 10 月 7 日 |
为这张六列表格设置约 660 px 的最小内容宽度。在 358 px 内容区内,表格外层提供独立横向滚动,并以轻微边缘渐隐或「左右滑动查看」提示剩余列;不能截断关键数值,也不能让整页出现水平滚动条。行比较是主要任务时保留原表格,不要未经验证就改成一组纵向卡片。

折叠长内容时保留操作入口
折叠规则应按内容类型区分,不能简单把整条回答截成「前 300 字」。一条回答超过三个屏高且包含四个以上小节时,可在开头提供章节跳转;正文默认完整可读,避免用户不知道关键结论被隐藏在哪里。
代码超过 24 行时,可以先展示 12 行,并标注「展开全部 48 行」;即使处于折叠状态,「复制代码」仍应复制完整 48 行。表格超过 20 行时,可先显示 10 行,使用「查看全部 28 行」明确说明余量;展开后保留表头,并让滚动与键盘焦点停留在当前表格区域。不要用只有省略号的按钮代替明确操作。
标记代码块仍在生成时,不提供“复制完整代码”。只有渲染层确认已收到完整代码块后才启用完整复制。若流式连接异常,明确标注内容不完整。
可运行的 Web 片段
下面的片段使用原生折叠、表头和有名称的滚动区。通过本机 HTTP 或 HTTPS 页面打开。浏览器支持剪贴板写入时,“复制完整代码”读取完整源码,折叠不改变取值。若写入失败,展开源码供手动选择,并给出状态提示。
<style>
.answer { max-inline-size: 48rem; min-inline-size: 0; margin: auto; }
.scroller { max-inline-size: 100%; min-inline-size: 0; overflow-x: auto; }
.scroller:focus-visible { outline: 2px solid #245db5; outline-offset: -2px; }
.scroller table { min-inline-size: 42rem; border-collapse: collapse; }
.scroller th, .scroller td { padding: .5rem; text-align: start; }
.scroller td.numeric { text-align: end; }
.scroller pre { inline-size: max-content; margin: 0; padding: .5rem; }
</style>
<article class="answer">
<h2>渠道订单</h2>
<button id="copy-code" type="button">复制完整代码</button>
<p id="copy-state" role="status"></p>
<details id="code-fold">
<summary>展开两行 Python 示例</summary>
<div class="scroller" tabindex="0" role="region" aria-label="Python 源码">
<pre><code id="source-code">for channel, count in {"自然搜索": 128, "广告投放": 92}.items():
print(f"{channel}:{count} 单")</code></pre>
</div>
</details>
<div class="scroller" tabindex="0" role="region" aria-label="渠道表格,可横向滚动">
<table>
<caption>渠道订单数据,截至 10 月 7 日</caption>
<thead>
<tr><th scope="col">渠道</th><th scope="col">已支付订单</th>
<th scope="col">GMV(元)</th><th scope="col">退款率</th>
<th scope="col">转化率</th><th scope="col">数据截止</th></tr>
</thead>
<tbody>
<tr><th scope="row">自然搜索</th><td class="numeric">128</td>
<td class="numeric">32,600</td><td class="numeric">2.3%</td>
<td class="numeric">4.8%</td><td>10 月 7 日</td></tr>
</tbody>
</table>
</div>
</article>
<script>
const output = document.querySelector("#copy-state");
document.querySelector("#copy-code").addEventListener("click", async () => {
try {
await navigator.clipboard.writeText(document.querySelector("#source-code").textContent);
output.textContent = "已复制完整代码。";
} catch {
document.querySelector("#code-fold").open = true;
output.textContent = "无法访问剪贴板,已展开,可手动复制源码。";
}
});
</script>需要行号时,把行号放在源文本之外,保证复制数据来自源码。应用渲染模型返回的 Markdown 时,应禁用或清理原始 HTML,按文本插入代码内容。展开/收起后保持焦点可见。组件还应保留局部滚动,避免表格或代码迫使整个聊天页横移。
用固定样本验证交互是否合格
分别以 1440 px 桌面视口和 390 px 手机视口测试包含 48 行代码、至少一行超过 100 个字符、六列二十八行表格的同一条回答,并逐项验收:
- 纵向滚动一屏后仍能通过标题区分结论、操作、代码和结果;正文不出现连续十几行未分段的文字墙。
- 手机页面没有水平溢出;左右拖动代码或表格时,只有对应容器发生横向位移。
- 折叠代码后点击复制,粘贴到纯文本编辑器仍有全部 48 行;语言标签、按钮文案和行号不混入源码。
- 表格滚动到最右侧能看到最后一列完整数值;用键盘也能聚焦并滚动表格,读屏可识别行列标题。
- 展开和收起不会清空筛选或跳到消息顶部;复制成功与失败均有可感知的文本反馈。
验收未通过时,优先检查滚动容器宽度、折叠状态所引用的原始内容及复制按钮的取值范围,而不是缩小全部字体来消除溢出。