For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/v0.2.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/v0.2.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/v0.2.0/components/ribbon.md.
  • 简体中文
  • v0.2.0
  • Ribbon 功能区

    Ribbon 把标签页导航与分组应用命令组合在一起。该模式源自 A3S Office,并被泛化到编辑器、拓扑工具与运维工作台。

    Live previewHTML · CSS · JavaScript
    Clipboard
    Font
    Paragraph

    文档画布

    使用

    加载 Tabs 控制器,并在根节点同时使用 ribbontabs 类名。

    <div class="ribbon tabs" data-accent="blue">
      <div role="tablist" aria-label="Editor commands">...</div>
      <div role="tabpanel">
        <fieldset data-ribbon-group>
          <legend>Clipboard</legend>
          ...
        </fieldset>
      </div>
    </div>

    参数

    参数可选值默认目的
    data-accentbluegreenorangepurpleblue产品或文档类型的重音
    role="tablist"必填选项卡导航容器
    aria-selectedtruefalse必填活动选项卡状态
    aria-controls / aria-labelledby元素 ID必填关联选项卡和面板
    data-ribbon-group必填命令组布局
    data-ribbon-controls推荐将命令与组图例上方对齐
    --ribbon-tabs-heightCSS 长度2.25rem固定标签栏高度
    --ribbon-panel-heightCSS 长度4.625rem固定命令区高度
    --ribbon-group-heightCSS 长度4.0625rem固定命令组高度

    状态和变体

    蓝色适合文档与通用工作区,绿色适合电子表格或健康状态,橙色适合演示文稿,紫色适合智能体工作流。禁用的标签页与命令使用原生 disabled。默认 36 像素标签栏和 74 像素命令区与 A3S Office 一致;紧凑视口保持标签不收缩并允许横向滚动。

    JavaScript API

    功能区行为来自 Tabs 控制器。window.a3sUI.refresh(ribbon) 重新扫描动态添加的选项卡。不需要功能区特定的 JavaScript。

    可访问性

    使用完整的标签键盘合约。使用 <fieldset> 和可见或仅屏幕阅读器的 <legend> 对命令进行分组。如果色带变得太密,请允许水平滚动,而不是将标签缩小到可见尺寸以下。