From 316d5ee43eb8ecd8bdfbddf7bcc1a99ea6051a93 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Tue, 6 Mar 2018 11:08:25 -0800 Subject: [PATCH] First draft of log role technique Needs the second example completed. --- techniques/aria/aria-log-role.html | 86 ++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 techniques/aria/aria-log-role.html diff --git a/techniques/aria/aria-log-role.html b/techniques/aria/aria-log-role.html new file mode 100644 index 00000000..90a1e6f3 --- /dev/null +++ b/techniques/aria/aria-log-role.html @@ -0,0 +1,86 @@ + + + + WCAG 2.0 Technique + + + +

Using ARIA role=log

+
+

Metadata

+

ID: W##

+

Technology: ARIA

+

Type: Technique

+
+
+

When to Use

+

This technique relates to: +

+

+
+
+

Description

+

+ The purpose of this technique is to notify Assistive Technologies (AT) when content has been appended to sequential information concerning the application's history or logs. The aria live region role of log has an implicit aria-live value of "polite" and aria-atomic value of "false", which allows a user to be notified via AT (such as a screen reader) when log messages are added. The new content within the aria-live region is automatically read by the AT, without the AT having to focus on the place where the text is displayed. See WAI-ARIA 1.1 log (role) for more details. + +

+ +
+
+

Examples

+
+

Updating the contents of a chat conversation

+

Comments that users type into a chat input field are appended to the end of the chat history region. The region is marked with role of log so that new additions are announced by ATs. The aria-relevant attribute is set to be "additions" only so that removed or edited messages are not re-announced. When each new chat message appears, a screen reader announces its content.

+
+ 
+						
+							

+								
Chat History

+								
    
+									
  • The latest chat message
    • 
+								

+							

+						
+
+
+

Working example: link

+
+
+

Updating the log of a server

+

+
+ 
+						
+
+						
+
+
+

Working example: link

+
+
+
+

Tests

+
+

Procedure

+ On a page that contains a log: +
    +
  1. Check that the log region is inside a container given a role of log.
    2. +
+
+
+

Expected Results

+
    +
  • #1 is true.
    • +
+
+
+
+

Related Techniques

+ +
+ + \ No newline at end of file