可调整宽度的侧边聊天抽屉应保持主任务上下文
规则和其他情况说明
侧边聊天抽屉适合在不离开主任务的情况下承载 AI 对话、生成结果和后续操作。可调宽度的关键不是“让面板尽可能大”,而是在主工作区和对话区之间提供可控的空间分配:抽屉始终锚定在同一侧,用户拖动边界后,主内容与聊天内容仍然保持可理解、可操作。
视频中的抽屉从较宽状态收窄,主工作区随之获得更多空间;同一聊天上下文、文件卡片、建议操作和输入框仍留在抽屉内部。深色和浅色主题也保持了相同的结构关系。
实现契约
- 抽屉应有明确的最小、最大和当前宽度,边界由主任务可用空间与聊天内容可读性共同决定;不要允许拖动把任一侧压缩到不可用。
- 用独立的拖拽边界承载调整手势,并给出足够的命中区域、
col-resize反馈和可访问名称;拖拽边界不能遮挡消息或输入框。 - 调整宽度时保持会话滚动位置、已输入内容、附件状态和焦点,不要因为布局重排重置对话。
- 抽屉内部的消息、文件卡片、建议操作和 composer 应采用可收缩布局;长文本、按钮和状态标识不能因变窄而溢出或互相覆盖。
- 宽度变化应即时反映在主工作区与抽屉之间的分栏关系中;如果实现带有缓动或吸附,需遵守
prefers-reduced-motion。 - 窄视口不应继续强行维持双栏;应切换为全宽抽屉、模态层或明确的堆叠布局,并保留返回主任务的路径。
- 浅色和深色主题共用结构 Token,分别校准表面、边界、分隔线、输入框和焦点环的对比度。
CSS Token
以下是接入项目时的变量边界示意,具体数值应由主任务内容、聊天行长和响应式断点校准:
.chat-drawer-shell {
--chat-drawer-size: var(--chat-drawer-current-size);
--chat-drawer-min-size: var(--chat-drawer-content-min-size);
--chat-drawer-max-size: var(--chat-drawer-layout-max-size);
--chat-drawer-resize-hit-size: var(--interactive-hit-size);
inline-size: clamp(
var(--chat-drawer-min-size),
var(--chat-drawer-size),
var(--chat-drawer-max-size)
);
}
.chat-drawer-resize-handle {
inline-size: var(--chat-drawer-resize-hit-size);
cursor: col-resize;
}
关键截图与效果

- 来源:Louis Nguyen Studio 在 X 发布的
Resizable Side-Drawer Chatbox Component演示视频。 - 页面或任务场景:用户在工作台中查看季度销售报告,同时使用右侧聊天抽屉请求生成和下载 PDF。
- 直接观察(E1):深色工作台左侧保留导航、中间保留主工作区,右侧抽屉占据较宽区域;抽屉中连续展示用户消息、工具调用结果、PDF 文件卡片、建议操作和底部输入框。
- 支持的结论:侧边对话可以在不离开主任务的情况下承载完整结果与下一步操作;宽抽屉适合需要阅读文件说明或较长回复的状态。
- 证据限制:单帧不证明拖拽命中区、键盘调整、滚动保持、最小宽度或真实内容加载行为。

- 来源:同一 X 演示视频的后续帧。
- 页面或任务场景:用户将聊天抽屉收窄,继续查看主工作台内容。
- 直接观察(E1):抽屉仍锚定在右侧,边界位置向右移动,中央工作区获得更多宽度;同一会话的消息、文件卡片、建议操作和输入框仍保持在抽屉内。
- 支持的结论:可调宽度应优先改变空间分配,而不是改变会话结构;主任务和辅助对话可以在同一页面保持并行可见。
- 证据限制:视频没有给出宽度数值、吸附规则、持久化策略、移动端断点或无障碍实现细节。
原始动态证据
适用场景
- AI 工作台、客服/CRM、数据分析和文档处理等需要边看主内容边对话的任务。
- 对话结果包含文件、建议操作或工具调用,用户需要在主页面继续核对和执行。
- 桌面宽屏场景下,用户希望自行决定主工作区与辅助面板的空间比例。
- 产品已有明确的主题 Token、响应式布局和键盘交互基础。
不适合直接照搬
- 移动端窄屏或主任务本身需要完整横向空间的界面;应先设计全屏或模态替代路径。
- 高风险操作需要强制确认的流程;可调整抽屉不能替代明确的确认和返回机制。
- 消息极短、无需并行查看上下文的简单问答;增加拖拽复杂度并不会带来收益。
- 没有明确最小宽度、焦点管理和退化方案,只复制“右侧面板 + 拖拽线”的视觉结构。
来源与证据边界
- 帖子正文将其称为
Resizable Side-Drawer Chatbox Component,并提供公开演示链接;这是作者对案例的命名与展示主张(P1)。 - 截图与视频来自该 X 帖子的公开媒体资源;为控制仓库体积,动态证据保存为官方可用的 720p 版本,关键帧保持完整画面、未裁剪。
- 视频证明了视觉上的宽度变化和主题变体,但未证明具体 CSS/JS 实现、断点、键盘无障碍、性能或生产环境验证,因此本条目保持
draft。