交互与用户体验 / 系统课时

呈现长答案中的代码与表格

呈现长答案中的代码与表格

当 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 代码块;按钮应复制全部四行,保留缩进与换行:

python
orders = {"自然搜索": 128, "广告投放": 92}
# 输出各渠道的已支付订单数,供核对复制结果。
for channel, count in orders.items():
    print(f"{channel}:{count} 单")

预期输出:

text
自然搜索: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 页面打开。浏览器支持剪贴板写入时,“复制完整代码”读取完整源码,折叠不改变取值。若写入失败,展开源码供手动选择,并给出状态提示。

html
<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 个字符、六列二十八行表格的同一条回答,并逐项验收:

  1. 纵向滚动一屏后仍能通过标题区分结论、操作、代码和结果;正文不出现连续十几行未分段的文字墙。
  2. 手机页面没有水平溢出;左右拖动代码或表格时,只有对应容器发生横向位移。
  3. 折叠代码后点击复制,粘贴到纯文本编辑器仍有全部 48 行;语言标签、按钮文案和行号不混入源码。
  4. 表格滚动到最右侧能看到最后一列完整数值;用键盘也能聚焦并滚动表格,读屏可识别行列标题。
  5. 展开和收起不会清空筛选或跳到消息顶部;复制成功与失败均有可感知的文本反馈。

验收未通过时,优先检查滚动容器宽度、折叠状态所引用的原始内容及复制按钮的取值范围,而不是缩小全部字体来消除溢出。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

呈现长答案中的代码与表格

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通