Anchor 设计文档

锚点导航,垂直链接列表。组合式 API:children + <Anchor.Link>(对齐 Semi,无 links 数组 prop)。支持 scroll-spy 激活高亮、点击平滑滚动、滑轨条随激活项定位、自定义滚动容器、多级嵌套、文字缩略 Tooltip、autoCollapse 动态展开。

← API 文档

使用建议

锚点导航,垂直链接列表。组合式 API:children + <Anchor.Link>(对齐 Semi,无 links 数组 prop)。支持 scroll-spy 激活高亮、点击平滑滚动、滑轨条随激活项定位、自定义滚动容器、多级嵌套、文字缩略 Tooltip、autoCollapse 动态展开。

Accessibility

ARIA role:navigation

  • nav[role=navigation][aria-label] 包裹链接列表;链接 role=link,激活链接 aria-current=location
  • 键盘:Tab 进入链接列表(roving,单一 Tab 停靠点);↑/↓ 移动焦点;Home/End 跳首/末;Space 激活并滚动
  • disabled 链接 aria-disabled=true 且从 roving 序列移除
  • scroll-spy 命令式监听 scroll(getContainer 时监听容器),rAF 节流,reduced-motion 下点击即时定位
  • 滑轨条据激活链接标题 offsetTop 绝对定位(对齐 Semi _setActiveSlide)
  • 多级嵌套用嵌套 Anchor.Link 表达层级树;扁平化树参与 scroll-spy,父子链接均可聚焦/跳转/高亮

设计变量

变量默认值用法
--cd-color-anchor-slide-default-bg-default var(--cd-color-border)滑轨背景颜色
--cd-color-anchor-slide-muted-bg-active var(--cd-color-white)选中颜色 - Muted
--cd-color-anchor-slide-primary-bg-active var(--cd-color-primary)选中颜色 - Primary
--cd-color-anchor-slide-tertiary-bg-active var(--cd-color-tertiary)选中颜色 - Tietrary
--cd-color-anchor-title-active-text-hover var(--cd-color-anchor-title-text-hover)文字颜色 - 选中悬浮态
--cd-color-anchor-title-bg-active transparent背景色 - 选中
--cd-color-anchor-title-bg-default transparent背景色
--cd-color-anchor-title-outline-focus var(--cd-color-primary-light-active)轮廓 - 聚焦
--cd-color-anchor-title-text-active var(--cd-color-text-0)文字颜色 - 选中
--cd-color-anchor-title-text-default var(--cd-color-text-2)文字颜色 - 未选中