For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/components/activity-bar.md.
  • 简体中文
  • next
  • 活动栏

    活动栏是 A3S 工作区使用的紧凑、持久的导航表面。它支持标签模式和仅图标模式,而无需更改语义导航。

    Live previewHTML · CSS · JavaScript

    用途

    <aside class="activity-bar" aria-label="Product navigation">
      <header>...</header>
      <nav aria-label="Primary"><ul>...</ul></nav>
      <footer>...</footer>
    </aside>

    HTML 结构

    元素或参数必填目的
    <aside class="activity-bar">组件根节点
    <nav aria-label="…">具名导航地标
    <ul><li>导航集合
    aria-current="page"当前项表示当前目标并应用对应样式
    data-navigation-label可选紧凑模式下隐藏标签
    data-labels="hidden"可选强制在根目录上仅显示图标

    状态和变体

    使用data-labels="hidden"作为独立图标支架。在App Shell内,data-navigation="collapsed"自动隐藏标签。链接支持默认、悬停、焦点可见和当前状态。按钮还支持aria-pressed="true"进行就地模式更改。

    可访问性

    折叠时将标签保留在 DOM 中。每个仅包含图标的链接或按钮仍然需要一个可访问的名称。当前页面使用 aria-current,而不是单独使用颜色。