0Pricing
Web Accessibility Academy · 课时

让控件失去声音的常见命名错误

避免导致元素没有名称的写法。

让控件失去声音的常见命名错误 是 CoddyKit 上的免费 Web Accessibility Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Web Accessibility Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Web Accessibility Academy 课程共包含 4 节课。

本课时的部分内容尚未翻译,以英文显示。

When Controls Go Silent

A control with no computed name is read as just button or link. These naming mistakes leave users guessing what an element does.

Icon-Only Buttons

A button holding only an icon often computes no name. Add an aria-label so the wordless control still announces its action.

<button aria-label="Delete">🗑️</button>

Placeholder Is Not a Name

A placeholder is not a reliable accessible name. It vanishes on typing and many readers ignore it, so add a real label.

<input placeholder="Email">

Broken labelledby IDs

An aria-labelledby pointing at a missing or misspelled id produces no name at all, silently undoing the label you intended.

<button aria-labelledby="ttl">x</button>

Empty aria-label

An aria-label set to an empty string wipes out the name. The element ends up with nothing for a screen reader to announce.

<button aria-label="">Save</button>

Hiding the Only Text

Putting aria-hidden on the only text inside a button removes its name source, so the control becomes anonymous to readers.

<button><span aria-hidden="true">Next</span></button>

Generic Link Text

Links named Read more or Click here are technically named but useless out of context, since users hear no destination.

<a href="/post">Read more</a>

Trusting title Alone

Relying on title as the only name is risky. It is the lowest priority source and several screen readers skip it entirely.

Inputs With No label

A bare input with no associated label often computes no name, leaving users unsure what to type into the field.

<input type="text">

Duplicated Names

Ten buttons all named Edit force users to guess which row they affect. Give each a distinct name that includes its target.

<button aria-label="Edit profile">Edit</button>

Verify With the Inspector

Open the browser accessibility panel and read the computed name for each control. If it is blank, you have a mistake to fix.

Quick Check

An icon button shows only a trash glyph. Why might it be silent?

Recap: Keep Controls Named

You learned the traps that silence controls, from icon-only buttons to broken ids, and to verify every name in the inspector. ✅

常见问题解答

「让控件失去声音的常见命名错误」课时是免费的吗?

是的 — 「让控件失去声音的常见命名错误」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Web Accessibility Academy 课程的其余内容,请升级到 CoddyKit PRO。 Web Accessibility Academy 课程共包含 4 节课。

「让控件失去声音的常见命名错误」这节课中我会学到什么?

避免导致元素没有名称的写法。 你通过在浏览器中直接运行的动手代码来练习 Web Accessibility Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Web Accessibility Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Web Accessibility Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。

「让控件失去声音的常见命名错误」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Web Accessibility Academy 课中编写并运行代码吗?

能。每节 Web Accessibility Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 无障碍名称计算揭秘
  2. aria-label 与 aria-labelledby
  3. 使用 aria-describedby 提供额外上下文
  4. 让控件失去声音的常见命名错误
← 返回 Web Accessibility Academy