ARIA 无障碍（ARIA Attributes）· 码译

读屏软件读不懂按钮

ARIA 无障碍

ARIA Attributes

反模式图标按钮没文字，视障用户听不出是干嘛的

正解用 aria-label / role 给无文字控件补含义，状态用 aria-* 同步

在线对比体验 · 同一个需求，大白话 vs 平台提示词，效果立分高下 · 右边可点击体验

大白话直接生成

🔍

读屏不知用途

平台提示词生成

🔍

有 aria-label

点一下试试

差在哪？大白话没讲「图标按钮没文字，视障用户听不出是干嘛的」，AI 只能自己猜；平台提示词写明「用 aria-label / role 给无文字控件补含义，状态用 aria-* 同步」，还带要点与三端注意，一次到位不用返工。

代码示例

错误写法

<button class='icon-only'>🔍</button> /* 读屏读出‘按钮’，不知用途 */

正确写法

<button aria-label='搜索'><svg/></button>

语义锚点 · 对齐 AI 语义库契约

<div data-vibe="aria-attributes"> … 组件根元素 … </div><!-- AI 用语义名片 locate 此属性即可定位/修改 -->

在组件根元素挂 data-vibe="aria-attributes"，AI 用语义名片里的 locate（[data-vibe='aria-attributes']）即可定位、修改、组合该组件——与「AI 语义库」tab 的契约一一对应。在 AI 语义库看契约 →

不同平台注意

网页ARIA 提升无障碍评分

AppRN 用 accessibilityLabel

小程序小程序用 aria-* 属性

可直接复制的提示词（三端都给你，挑对应平台复制给 Cursor / 通义灵码 / Claude）

网页 Web

你是一位资深前端工程师。我想实现【ARIA 无障碍】（专业术语：ARIA Attributes）。

【我想达到的效果】读屏软件读不懂按钮。
【请避免的反模式】图标按钮没文字，视障用户听不出是干嘛的。
【正确做法】用 aria-label / role 给无文字控件补含义，状态用 aria-* 同步。

【平台】网页 Web（标准 HTML/CSS/JS，单文件零依赖，不引任何 CDN）。
【提示词要点】
- 图标按钮必加 aria-label
- 弹窗用 role='dialog' + aria-modal
- 动态内容用 aria-live 播报

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

手机 App

你是一位资深前端工程师。我想实现【ARIA 无障碍】（专业术语：ARIA Attributes）。

【我想达到的效果】读屏软件读不懂按钮。
【请避免的反模式】图标按钮没文字，视障用户听不出是干嘛的。
【正确做法】用 aria-label / role 给无文字控件补含义，状态用 aria-* 同步。

【平台】手机 App（React Native / Flutter / 原生，给出对应组件与关键代码）。
【提示词要点】
- 图标按钮必加 aria-label
- 弹窗用 role='dialog' + aria-modal
- 动态内容用 aria-live 播报

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

微信小程序

你是一位资深前端工程师。我想实现【ARIA 无障碍】（专业术语：ARIA Attributes）。

【我想达到的效果】读屏软件读不懂按钮。
【请避免的反模式】图标按钮没文字，视障用户听不出是干嘛的。
【正确做法】用 aria-label / role 给无文字控件补含义，状态用 aria-* 同步。

【平台】微信小程序（WXML/WXSS/JS，注意 rpx 单位与小程序专属约束）。
【提示词要点】
- 图标按钮必加 aria-label
- 弹窗用 role='dialog' + aria-modal
- 动态内容用 aria-live 播报

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。