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-plan.md.

任务计划

任务计划用有限步骤展示可观察的工作顺序,不把内部推理直接暴露为界面文案。计划创建、步骤流转、持久化与取消由宿主应用负责。

实时预览

发布计划

四个步骤已完成两个

进行中
  1. 检查包变更

    审阅导出入口和发布元数据。

    已完成
  2. 运行聚焦检查

    验证包与文档契约。

    已完成
  3. 审阅界面状态

    检查窄屏、深色和键盘行为。

    进行中
  4. 准备交付

    汇总已验证结果与剩余风险。

    待处理

计划步骤只描述可观察的工作与结果。

用法

<section class="task-plan" data-state="active" aria-labelledby="plan-title">
  <header>
    <h2 id="plan-title">发布计划</h2>
    ...
  </header>
  <ol>
    <li class="plan-step" data-state="complete">...</li>
    <li class="plan-step" data-state="active" aria-current="step">...</li>
  </ol>
  <footer>...</footer>
</section>

参数

API取值用途
data-statedraft、active、paused、complete、error计划生命周期
data-variantplain移除计划自身表面,供检查器或会话分区直接承载
直接子 <ol>必须有序计划步骤
data-plan-status推荐可见生命周期文案
原生进度条语义可选有界总进度

状态与变体

暂停执行时保留已完成步骤和当前步骤。单个步骤失败时优先在该计划步骤上标记,只有整个计划无法继续时才使用计划级错误。父级表面已经拥有边界时才使用 data-variant="plain";它移除任务计划的边框和行内边距,但不改变步骤语义。

<section class="task-plan" data-state="active" data-variant="plain">
  <header>
    <h2>执行计划</h2>
    <span data-plan-status>进行中</span>
  </header>
  <ol>
    <li class="plan-step" data-state="active" aria-current="step">...</li>
  </ol>
</section>

无障碍

使用标题命名整个区域,并且只出现一个 aria-current="step"。不显示可视进度条时仍需提供文本进度。