For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/v0.4.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/v0.4.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/v0.4.0/components/task-workspace.md.

任务工作区

任务工作区把标题、按时间排序的记录、底部输入器和可选产物检查器放在同一个有边界的应用区域中。

实时预览

发布就绪审查

  1. 审查发布变更并指出阻塞风险。

  2. 已审查包、文档和发布检查。

    已完成 3 个步骤发布检查

用法

<section class="task-workspace">
  <header class="workspace-header">
    <button type="button" data-task-inspector-trigger>打开文件</button>
  </header>
  <div data-task-body>
    <main data-task-main>
      <section class="agent-transcript">...</section>
      <form class="agent-composer">...</form>
    </main>
    <aside id="task-files" class="task-pane" data-task-inspector>...</aside>
  </div>
</section>

参数

API可选值用途
data-task-body必填管理主区域和检查器列
data-task-main必填任务记录和输入器的滚动约定
data-task-inspector可选产物、文件、引用或上下文检查器
data-task-inspector-trigger可选打开或关闭响应式检查器,并接收关闭后的焦点
data-inspectorhidden、open、省略检查器可见性和响应式浮层状态

JavaScript API

导入 @a3s-lab/ui/all,或者先导入 @a3s-lab/ui/runtime,再导入 @a3s-lab/ui/task-workspace。控制器只初始化一次,并在根元素上提供 openInspector()、closeInspector()、toggleInspector() 与 refresh()。状态变化后会派发 a3s:task-inspector-change,详情为 { open, mode, source }。

状态和变体

低于 900 像素时,检查器退出网格,只在 data-inspector="open" 时覆盖显示。低于 520 像素时改为底部浮层。控制器会为关闭状态设置 inert 与 aria-hidden="true",打开时移除这些属性,并支持 Escape、遮罩关闭和焦点归还。所有状态下任务记录与输入器的 DOM 顺序保持不变。产品若需要在所有宽度彻底移除检查器,可使用 data-inspector="hidden"。

无障碍

为任务记录、检查器和控件提供名称。关闭检查器时把焦点还给触发器。只播报有边界的执行状态变化,不把整段任务记录设为实时区域。