ARIA Live Region Announcer Overlay

WHAT IT DOES

ARIA Live Region Announcer Overlay scans the current page for ARIA live regions (role="status", role="alert", aria-live="polite/assertive") and dynamically updated content. It extracts announcements, notifications, and status messages from live regions as they appear. The floating panel shows a history of all ARIA announcements with timestamps, source elements, and priority levels. Announcements can be reviewed, filtered by live region type and time range, and played back using text-to-speech (TTS). The announcement history can be copied or exported as JSON or text. Repeated announcements and missing ARIA live region attributes are highlighted, and suggestions for improving accessibility are provided based on announcement patterns.

WHERE IT RUNS

Works on any web page that uses ARIA live regions for dynamic content updates, including accessibility-focused applications, single-page apps, notification systems, and dynamic form validation. The script detects live regions using ARIA attributes (role="status", role="alert", aria-live) and monitors them for content changes. It works best on modern web applications that implement ARIA live regions for screen reader accessibility.

HOW TO USE

The panel displays a log of all detected announcements with timestamps and type indicators. Click "Scan Regions" to detect all live regions on the page and capture their current content. Click "Start Listening" to begin monitoring live regions for new announcements as they appear. Use the log to review past announcements, with priority levels color-coded (green for polite/status, yellow for assertive, red for alerts). Enable TTS to have announcements spoken aloud as they occur. The Analysis section shows announcement statistics, identifies repeated announcements, and provides suggestions for improving ARIA attributes. Copy the log as text or export as JSON for documentation.

MECHANISM — MUTATION OBSERVER WITH ARIA ATTRIBUTE DETECTION

The script uses MutationObserver to monitor ARIA live regions for content changes. It first scans the page for elements with role="status", role="alert", aria-live="polite", or aria-live="assertive" using CSS selectors. For each detected live region, it attaches a MutationObserver that watches for childList, subtree, and characterData changes. When a change is detected, the new text content is compared to the previous content, and if different, a new announcement entry is created. Each entry includes the type, priority level, label (from aria-labelledby or aria-label), content, and timestamp. The analysis engine counts announcements by type, detects repeated content, and identifies elements with missing or invalid ARIA attributes. All monitoring runs client-side with no network calls.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including TTS preferences and log retention, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all announcement logs and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only announcement content, timestamps, and ARIA attribute data from publicly visible page content. The script does not modify the page; it only observes and logs announcements. TTS uses the browser's built-in SpeechSynthesis API and requires user interaction to start. Data persists across browser sessions and is isolated per browser profile.