@ablogcms/a11y

a-blog cms 管理画面向けのアクセシビリティ関連ユーティリティ集。

announce

スクリーンリーダー向けの非表示ライブリージョンへメッセージを流す。

視覚的なポップアップを伴う通知（トースト等）とは異なり、構造操作のような視覚変化が乏しい 操作の完了を、支援技術の利用者にだけ軽量に伝えたい場面で使う。

import { announce } from '@ablogcms/a11y';

announce('選択したブロックをグループ化しました');

// 緊急度の高い通知（エラー等）は 'assertive' を指定する（既定は 'polite'）
announce('保存に失敗しました', 'assertive');

aria-live="polite" / aria-live="assertive" それぞれに対応する非表示（クリップされた）領域を document.body 直下に1つずつ作り、呼び出しのたびに textContent を空にしてから遅延セットする。 直前と同じメッセージを連投しても DOM 変化として検知され読み上げられる。