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

能力目录

能力目录为数量较多、需要搜索和筛选的能力集合提供页面级骨架。只有“发现并选择能力”是当前主任务时才使用它;小型集合应使用普通列表或资源网格。

实时预览

能力

查找可复用的技能、连接器和工作模板。

  • 发布检查

    汇总验证结果与发布证据。

  • 研究工作区

    收集、比较并整理来源材料。

  • 代码审查

    聚焦变更范围和质量信号。

3 项能力
代码审查A3S Lab

检查聚焦变更与相关证据。

已安装
文档规划A3S Lab

规划双语文档与验收范围。

按需添加

用法

目录根节点只拥有页面排列。搜索、筛选、排序、安装和数据请求仍由宿主实现;结果项组合资源卡片、列表或表格。

<section class="catalog" aria-labelledby="capability-catalog-title">
  <header>
    <div data-catalog-identity>
      <h1 id="capability-catalog-title">能力</h1>
      <p>查找可复用的技能、连接器和工作模板。</p>
    </div>
    <div data-catalog-actions>
      <label for="capability-search">搜索能力</label>
      <input
        class="input"
        id="capability-search"
        type="search"
        placeholder="搜索名称或用途"
      />
    </div>
  </header>
  <div data-catalog-toolbar>
    <div data-catalog-filters aria-label="能力类型"></div>
    <div data-catalog-actions>
      <output data-catalog-count>12 项能力</output>
    </div>
  </div>
  <div data-catalog-results aria-label="能力结果"></div>
</section>

参数

API必填用途
data-catalog-identity是页面标题与简短说明
data-catalog-actions否搜索、排序、视图或所有权操作
data-catalog-featured否数量有限且确实需要强调的精选集合
data-catalog-toolbar推荐筛选、结果数量与排序
data-catalog-filters否一组具有可见选中状态的筛选器
data-catalog-count推荐筛选后的结果数量
data-catalog-results是网格、列表、表格或状态反馈

状态与变体

ready 显示稳定结果;loading 保留标题、筛选器和结果区域尺寸;empty 解释当前条件没有匹配项并提供清除筛选;error 说明失败原因和重试路径;partial 表明仍在分页或加载更多结果。

实时预览

能力

当前筛选条件没有匹配结果。

研究 · 已安装
0 项能力

没有符合条件的能力

清除“已安装”筛选,或尝试更宽泛的关键词。

精选区不是永久广告位。只保留少量、可解释的推荐,并在手机上堆叠为完整条目;不要用被裁切的横向卡片掩盖主要结果。目录中不同资源类型共享搜索与选择规则,类型差异由可见元数据表达。

可访问性

目录必须有唯一页面标题,搜索输入框需要可见或隐藏标签,筛选按钮使用 aria-pressed 或等价选择语义。筛选后在 data-catalog-count 中礼貌播报结果数量,但不要移动焦点或重置滚动。加载、空白和错误状态保留标题与筛选上下文;重试或清除筛选后把焦点留在原控件。精选条目和结果条目使用真实链接或按钮,不能让整张卡片与内部操作形成嵌套点击目标。宿主负责查询、分页、推荐依据、安装权限和可信元数据;组件只负责信息架构与响应式排列。