实时区域为何失效以及如何修复

Live regions look simple but fail often. Knowing the common pitfalls saves hours of confused testing with a real screen reader. 🐛

If you create the region and its text in the same moment, many readers miss it. The region must exist empty before the change.

Add the live container on page load with no text, then update its content later. The screen reader is already watching it by then.

Writing the same string twice often produces silence, because the reader sees no change. Repeated counts and statuses hit this a lot.

Empty the region, then set the new text on the next tick. The brief reset makes the reader treat it as a fresh announcement.

Updating a region with a huge block of text floods the user. Live regions are for short updates, not full page content.

Set aria-atomic to true and the reader speaks the whole region on any change, not just the part that updated. Useful for combined messages.

The aria-relevant attribute controls which change types announce, such as additions or removals. The default of additions plus text suits most cases.

A region hidden with display none is removed from the accessibility tree and stays silent. This is one of the most common mistakes.

Browser inspectors will not prove a region works. Always verify with a real screen reader like NVDA or VoiceOver before you ship.

The same live region can sound different across screen readers and browsers. Test a couple of combinations rather than trusting just one.

Your live region stays silent when you write the same count twice in a row. What reliably fixes it?

You can now debug live regions: render empty first, clear then set for repeats, avoid display none, and always test on a real reader. ✅