Skip to content

视觉隐藏

使用方法 ​

从独立入口导入 VisuallyHidden。默认插槽为必需项:

vue
<script setup lang="ts">
import { VisuallyHidden } from '@astryx-vue/core/VisuallyHidden'
</script>

<template>
  <a href="/articles/accessibility">
    了解更多
    <VisuallyHidden>关于无障碍基础组件</VisuallyHidden>
  </a>
</template>

最佳实践 ​

指引实践
推荐用于为纯图标按钮和控件提供屏幕阅读器可播报的无障碍名称。
推荐以块级元素(as="div")渲染,并设置 aria-live,用于播报拖放或结果数量等动态更新。
避免用它对所有人隐藏内容。内容仍保留在无障碍树中。如需完全移除,应使用条件渲染或 hidden。
避免在其中放置交互控件。内容不可见,也无法接收指针输入。

示例 ​

为辅助技术补充视觉界面没有表达的上下文与动态状态。

补充上下文

在简短链接后补充只供屏幕阅读器读取的上下文,避免链接脱离页面后含义不明。

实时播报

Items added: 0

使用块级根元素和 aria-live 播报视觉界面中的动态更新。隐藏内容仍保留在无障碍树中。