<tab-容器>元素
带有键盘支持的可访问标签容器元素 。 跟着 ARIA 标签最佳做法指南。 。 。 .
安装
$ npm install @github/tab-container-element
使用量
import '@github/tab-container-element'
<tab-container>
<button type="button" id="tab-one" role="tab" aria-selected="true">Tab one</button>
<button type="button" id="tab-two" role="tab" tabindex="-1">Tab two</button>
<button type="button" id="tab-three" role="tab" tabindex="-1">Tab three</button>
<div role="tabpanel" aria-labelledby="tab-one">
Panel 1
</div>
<div role="tabpanel" aria-labelledby="tab-two" hidden>
Panel 2
</div>
<div role="tabpanel" aria-labelledby="tab-three" hidden>
Panel 3
</div>
</tab-container>
如果没有标签 aria-selected=true,然后自动选择第一个标签。 您还可以添加 default-tab=N 属性以避免设置 aria-selected=true 选项卡上 N 是基于 0 的标签索引 :
<!-- The _second_ tab will be selected -->
<tab-container default-tab="1">
<button type="button" id="tab-one" role="tab">Tab one</button>
<button type="button" id="tab-two" role="tab">Tab two</button>
<button type="button" id="tab-three" role="tab">Tab three</button>
<!-- ... -->
</tab-container>
活动
tab-container-change(泡泡,可取消):发射<tab-container>在选择新标签和更新能见度之前.event.tab是将被聚焦的标签,event.tabIndex是基于 0 的索引tab财务报告和审定财务报表tab.panel如果事件未取消, 将会显示的面板 .tab-container-changed(泡泡):开火<tab-container>在选择新标签并更新能见度后.event.tab是当前正在运行的标签(并且将在此事件之后集中),event.tabIndex是基于 0 的索引tab财务报告和审定财务报表event.panel是新可见的标签面板.
方法
selectTab(tabIndex, options: {focus?: boolean} = {}): 程序上用给定的以0为基础的索引选择标签并显示其面板。 点燃上述事件。 默认情况下,将焦点设置到选定的标签;调用{focus: false}为了防止这种情况.
部件
::part(tablist-wrapper)是包含before-tabs, (中文(简体) ),tablist财务报告和审定财务报表after-tabs。 。 。 .::part(tablist)是包装所有标签的容器。 这个元素在ATs中现出role=tablist。 。 。 .::part(panel)是当前活动小板的容器.::part(before-tabs)容器中包含任何在第一个role=tab。这也可以直接与slot=before-tabs该容器位于元素外,其作用=列表以遵守ARIA准则.::part(after-tabs)容器中包含任何在上一页之后出现的元素role=tab。这也可以直接与slot=after-tabs该容器位于元素外,其作用=列表以遵守ARIA准则.::part(after-panels)容器中包含任何在上一页之后出现的元素role=tabpanel。如果想要在容器中添加视觉处理,但内容总是显示在活动面板下.
当标签面板内容为控件时
启动后,整个标签面板将获得焦点. 如果标签面板本身由交互式元素组成,例如动作列表或收音机按钮,这可能不可取.
在这些情况下,适用 data-tab-container-no-tabstop 页:1 tabpanel 键.
<tab-container>
<button type="button" id="tab-one" role="tab" aria-selected="true">Tab one</button>
<button type="button" id="tab-two" role="tab" tabindex="-1">Tab two</button>
<div role="tabpanel" aria-labelledby="tab-one" data-tab-container-no-tabstop>
<ul role="menu" aria-label="Branches">
<li tabindex="0">branch-one</li>
<li tabindex="0">branch-two</li>
</ul>
</div>
<div role="tabpanel" aria-labelledby="tab-two" data-tab-container-no-tabstop hidden>
<ul role="menu" aria-label="Commits">
<li tabindex="0">Commit One</li>
<li tabindex="0">Commit Two</li>
</ul>
</div>
</tab-container>
垂直标签
若为 <tab-container> 给出 vertical 属性将应用 aria-orientation=vertical 属性到标签列表。 这将以垂直制表列表的形式呈现给ATs,您可以据此使用属性来样式制表符.
在这些情况下,适用 data-tab-container-no-tabstop 页:1 tabpanel 键.
<tab-container vertical>
<button type="button" id="tab-one" role="tab" aria-selected="true">Tab one</button>
<button type="button" id="tab-two" role="tab" tabindex="-1">Tab two</button>
<div role="tabpanel" aria-labelledby="tab-one" data-tab-container-no-tabstop>
<ul role="menu" aria-label="Branches">
<li tabindex="0">branch-one</li>
<li tabindex="0">branch-two</li>
</ul>
</div>
<div role="tabpanel" aria-labelledby="tab-two" data-tab-container-no-tabstop hidden>
<ul role="menu" aria-label="Commits">
<li tabindex="0">Commit One</li>
<li tabindex="0">Commit Two</li>
</ul>
</div>
</tab-container>
未管理槽
<tab-container> 旨在简化 ShadowDOM 中复杂的标记,从而使您最终编写的 HTML 总体上减少。 然而,有时,如果 满 控制标记。 每一个 ::part 选择器也是 <slot>s,这表示你可以参与任何角色并进行分档,凌驾于内置的ShadowDOM之上.
未管理 tablist
你可以自己提供 role=tablist 财务报告和审定财务报表 <tab-container> 将容纳。 如果您在标签列表中需要额外的演示标记, 这将会有所帮助 。 但记住:
- 您必须确保所有的孩子元素
role=tab或者说role=presentational。 。 。 . - 该元素仍然会在此元素前后放置内容档,以便正确显示标签列表.
<tab-container>
<div role="tablist">
<my-icon name="tabs" role="presentational"></my-icon>
<button type="button" role="tab">Tab one</button>
<button type="button" role="tab">Tab two</button>
</div>
<div role="tabpanel"></div>
<div role="tabpanel"></div>
</tab-container>
未管理 tablist-tab-wrapper
你可以把时间档 tablist-tab-wrapper 页:1 此槽管理标签, 但不管理元素的前后 。 这样,您可以将自定义的 HTML 设置在标签列表中. 记住,如果你提供这个元素:
- 您还必须提供
role=tablist小时候. - 您必须确保所有的孩子元素
role=tab或者说role=presentational。 。 。 . - 该元素仍然会在此元素前后放置内容档,以便正确显示标签列表.
<tab-container>
<div slot="tablist-tab-wrapper">
<div role="tablist">
<button type="button" role="tab">Tab one</button>
<button type="button" role="tab">Tab two</button>
</div>
</div>
<div role="tabpanel"></div>
<div role="tabpanel"></div>
</tab-container>
未管理 tablist-wrapper
如果您想完全控制整个制表区域,包括管理制表前和制表后的内容,那么您可以将制表符排入 tablist-wrapper 键。 记住,如果你提供这个元素:
<tab-container>将仅管理role=panel它不会在标签或面板之前或之后管理元素.- 你连时间都打不开
tablist-tab-wrapper。您可以选择省略此元素. - 您还必须提供
role=tablist作为后人. - 您必须确保列表中的所有儿童元素
role=tab或者说role=presentational。 。 。 . - 该元素仍然会在此元素前后放置内容档,以便正确显示标签列表.
<tab-container>
<div slot="tablist-wrapper">
<div role="tablist">
<button type="button" role="tab">Tab one</button>
<button type="button" role="tab">Tab two</button>
</div>
</div>
<div role="tabpanel"></div>
<div role="tabpanel"></div>
</tab-container>
浏览器支持
浏览器, 不本地 自定义元素支持 需要一个 多边填充。 。 。 .
- 颜色
- 火花
- 萨法里
- 微软边缘
发展
npm install
npm test
许可证
以麻省理工学院许可证分发。 详情见LICENSE.