Re: [w3ctag/design-reviews] Review request for AriaNotify API (Issue #1075)

janewman left a comment (w3ctag/design-reviews#1075)

Hi Lola, 

Thanks for helping to move this along. Let me know if you have any follow-up questions or asks for clarification. 

1. **Do you foresee this somehow being extended to support earcons (possibly with text fallbacks) in future?** 
The [Proposal - Type](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/Accessibility/AriaNotify/explainer.md#proposal---type) section of the explainer provides more details, but we are considering an optional `type` parameter that will allow for further customization of the notification experience, and this type could be used by screen readers to implement earcons. 

2. **What implications would that have for the function signature?** 
This `type` is an optional second parameter with a reasonable default value, so there will be no need for authors to adjust existing implementations unless they would like to update to include this additional context. Alternatively, the type may be expressed in an object form with property type.  
```js
// Notify of a long-running async task starting and ending  
document.ariaNotify( 
    "Uploading file untitled-1 to the cloud.", 
    "task-progress-started" );  
// ...  
myfile.asyncFileUpload().then( () => {  
    document.ariaNotify( "File untitled-1 uploaded.", {  
         type: "task-progress-finished" } );  
});  
```
This has already been implemented in chromium and is available in both the v1 and v2 implementations, so this will be ready for testing once we unblock AT support and have confirmed that this can be added on seamlessly with the existing API and shipped progressively without any impact to compatibility. Here is where we are discussing with the working group to better understand the right structure for type: [[AriaNotify] Should notificationId be a non-localized string? Is notificationId needed at all? · Issue #2330 · w3c/aria](https://github.com/w3c/aria/issues/2330) 

3. **In the explainer you mention: _A previous version of this explainer included an interrupt property (now described below). It seems unlikely that any implementers will include this property in their initial implementation._ Why is that?** 

Other than UIA, no other platform API supports an interrupt in their notification API, and while UIA technically supports interrupt, not in the way that we intend to specify it. We are working with them to build a proof of concept.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3ctag/design-reviews/issues/1075#issuecomment-2899494140
You are receiving this because you are subscribed to this thread.

Message ID: <w3ctag/design-reviews/issues/1075/2899494140@github.com>