| CARVIEW |
Select Language
HTTP/2 200
content-type: text/html
x-guploader-uploadid: AAwnv3J2aILeOefguQ_fWPn7ZIpJOS1uH53Ln5neR1JPl8Imt3CkvhuYk4jx5utjMzIw7Ykz
cache-control: public, max-age=3600
expires: Tue, 07 Oct 2025 21:23:01 GMT
last-modified: Tue, 07 Oct 2025 01:13:56 GMT
etag: W/"f97116c14609529dc60a96cfaf625264"
x-goog-generation: 1759799636472194
x-goog-metageneration: 1
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 171887
x-goog-meta-goog-reserved-file-mtime: 1759797911
x-goog-hash: crc32c=44D1xw==, md5=+XEWwUYJUp3GCpbPr2JSZA==
x-goog-storage-class: STANDARD
accept-ranges: none
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
alt-svc: clear
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
strict-transport-security: max-age=63072000
content-security-policy: default-src 'self'; script-src 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; script-src-elem 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; style-src 'report-sample' 'self' 'unsafe-inline'; object-src 'none'; base-uri 'self'; connect-src 'self' developer.allizom.org bcd.developer.allizom.org bcd.developer.mozilla.org updates.developer.allizom.org updates.developer.mozilla.org https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com https://incoming.telemetry.mozilla.org https://observatory-api.mdn.allizom.net https://observatory-api.mdn.mozilla.net https://api.github.com/search/issues stats.g.doubleclick.net https://api.stripe.com; font-src 'self'; frame-src 'self' interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net mdn.github.io live-samples.mdn.mozilla.net live-samples.mdn.allizom.net *.mdnplay.dev *.mdnyalp.dev *.play.test.mdn.allizom.net https://v2.scrimba.com https://scrimba.com jsfiddle.net www.youtube-nocookie.com codepen.io survey.alchemer.com https://js.stripe.com; img-src 'self' data: *.githubusercontent.com *.googleusercontent.com *.gravatar.com mozillausercontent.com firefoxusercontent.com profile.stage.mozaws.net profile.accounts.firefox.com developer.mozilla.org mdn.dev interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net wikipedia.org upload.wikimedia.org https://mdn.github.io/shared-assets/ https://mdn.dev/ https://*.google-analytics.com https://*.googletagmanager.com www.gstatic.com; manifest-src 'self'; media-src 'self' archive.org videos.cdn.mozilla.net https://mdn.github.io/shared-assets/; child-src 'self'; worker-src 'self';
x-frame-options: DENY
origin-trial: AxVILwizhbMjxFeHOn1P3R8niO1RJY/smaK4B4d1rLzc1gTaxtXMSaTi+FoigYgCw40uFRDwFcEAeqDR+vVLOW4AAABfeyJvcmlnaW4iOiJodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZyIsImZlYXR1cmUiOiJQcml2YXRlQXR0cmlidXRpb25WMiIsImV4cGlyeSI6MTc0MjA3OTYwMH0=
x-cloud-trace-context: 11325e321314ce931a29214e93bbe405
date: Tue, 07 Oct 2025 20:23:01 GMT
server: Google Frontend
via: 1.1 google
vary: Accept-Encoding
content-encoding: gzip
x-cache: miss
log ロールの使用 - ARIA | MDN
Toggle sidebar
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
log ロールの使用
説明
このテクニックは、log ロールを使用する方法を示し、ブラウザーと支援技術に与える影響について説明します。
log ロールは、新しい情報が意味のある順序で追加され、古い情報が消えるライブリージョンを作成する要素を識別するために使用されます。 たとえば、チャットログ、メッセージ履歴、エラーログなどです。 他のタイプのライブリージョンとは対照的に、このロールは順番に並べられ、新しい情報はログの末尾にのみ追加されます。 このロールが要素に追加されると、ブラウザーは支援技術製品にアクセス可能なログイベントを送信し、ユーザーにそれを通知することができます。
デフォルトでは、更新にはライブリージョンの変更のみが含まれ、ユーザーがアイドル状態のときにアナウンスされます。 変更の際にライブリージョン全体を聞く必要がある場合、 aria-atomic="true" を設定するべきです。 できるだけ早くアナウンスし、ユーザーが中断する可能性がある場合は、より積極的な更新のために aria-live="assertive" を設定することができます。
ユーザーエージェントと支援技術への影響
要素に log ロールが追加されたとき、またはそのような要素が可視になるとき、ユーザーエージェントは以下を行うべきです。
- オペレーティングシステムのアクセシビリティ API で
logロールを持つ要素を公開します。 - オペレーティングシステムのアクセシビリティ API がサポートされている場合は、アクセシビリティ API を使用してアクセス可能なログイベントを発生させます。
支援技術製品は、そのようなイベントをリスンし、それに応じてユーザーに以下を通知するべきです。
aria-live="assertive"が設定されておらず、ユーザーが中断されている場合を除き、スクリーンリーダーは、ユーザーがアイドル状態のときにログ内の変更をアナウンスするべきです。- スクリーン拡大鏡は、ログ更新が発生したことを視覚的に示すことができます。
メモ: 支援技術がどのようにこの技術を扱うべきかについての意見は異なる場合があります。 上記の情報は、これらの意見の 1 つで、したがって規範的ではありません。
例
例 1: HTML コードにロールを追加する
以下のスニペットは、log ロールを HTML ソースコードに直接追加する方法を示しています。
html
<div id="liveregion" class="region" role="log"></div>
例 2: サンプルアプリケーションからのスニペット
このスニペットは AJAX チャットアプリケーションにおいてチャットログを作成します。
html
<div id="chatArea" role="log">
<ul id="chatRegion" aria-live="polite" aria-atomic="false">
<li>AJAX チャットの使用を開始するには、ユーザー名を選択してください。</li>
</ul>
<ul
id="userListRegion"
aria-live="off"
aria-relevant="additions removals text"></ul>
</div>
動作する例
注
- 要素に
logロールを使用すると、その要素にはaria-live="polite"が暗黙で含まれます。 - 株式相場表示機のようにスクロールするテキストがある領域では、
marqueeロールを代わりに使用するべきです。
使用された ARIA 属性
関連する ARIA 技術
- marquee ロール
互換性
TBD: 一般的な UA と AT 製品の組み合わせに関するサポート情報を追加する
その他のリソース
- ARIA のベストプラクティス - ライブリージョンの実装: https://www.w3.org/TR/wai-aria-practices/#LiveRegions