You need to enable JavaScript to run this app. VoiceOver光标与键盘焦点不一致:保存到作品集按钮无法被键盘聚焦
优惠活动
大模型
产品
解决方案
定价
更多

VoiceOver光标与键盘焦点不一致:保存到作品集按钮无法被键盘聚焦

使用VoiceOver导航时似乎跳过了键盘焦点

问题根因

  • 外层包裹的<div>被额外设置了role='button'属性,但该div没有配置tabindex,本身不支持键盘聚焦。VoiceOver识别到这个无交互能力的自定义按钮元素后,会直接跳过该区域,进而导致内部的真实按钮也无法被焦点捕获
  • 该role='button'属于完全冗余配置:你已经在容器内部使用了原生可交互的Button组件作为下拉触发器,外层容器仅需要承担布局和失焦关闭的逻辑,不需要额外声明按钮角色

修复方案

直接删除外层div的role='button'属性即可解决焦点被跳过的问题,同时建议补充标准ARIA属性提升组件的无障碍兼容性,修改后的代码如下:

const DropDown = ({ sxStyle, sxTiny, buttonLabel, options }) => {
  const [open, setOpen] = useState(false)
  const toggleStyle = sxTiny ? sxStyle.tiny : sxStyle.toggle
  const wrapperStyle = sxTiny ? sxStyle.tinyWrapper : sxStyle.wrapper

  return (
    <div
      className='wrapper'
      sx={wrapperStyle}
      onBlur={(event) => {
        if (!event.currentTarget.contains(event.relatedTarget)) {
          setOpen(false)
        }
      }}
    >
      <Button
        variant='primary'
        className='dropdown-toggle'
        aria-label='Add to Portfolio'
        onClick={() => setOpen(!open)}
        sx={toggleStyle}
        // 补充标准ARIA属性提升无障碍兼容性
        aria-expanded={open}
        aria-haspopup="listbox"
        id="portfolio-dropdown-trigger"
      >
        { buttonLabel }
      </Button>
      <div
        role='listbox'
        aria-labelledby="portfolio-dropdown-trigger"
        sx={open ? sxStyle.optionsOpen : sxStyle.optionsClosed}>
        { options }
      </div>
    </div>

  )
}

如果需要进一步完善键盘交互,可以给Button组件补充onKeyDown事件,处理回车、空格触发下拉开关,上下方向键打开下拉并定位到选项的逻辑。

内容的提问来源于stack exchange,提问作者Paul

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 09:57:02