RE: drawsystemfocusring/drawcustomfocusring

That sounds ok, though the text currently  says a child of the canvas element. If it can be a child of a child, we probably should update that too.

Sent from my Windows Phone
________________________________
From: Richard Schwerdtfeger
Sent: 12/13/2013 8:27 AM
To: Jay Munro
Cc: Rik Cabanier; Dominic Mazzoni; eoconnor@apple.com; Jatinder Mann; Canvas
Subject: RE: drawsystemfocusring/drawcustomfocusring


I would recommend one tweak.

We should say rendered descendant rather than rendered child to be more accurate.

There will be instances where the child may not be a direct child of the canvas element. For example, it may be a child of a child.

 Rich



Rich Schwerdtfeger

[Inactive hide details for Jay Munro ---12/12/2013 02:21:31 PM---With scrollpathintoview, how does this sound for the two lines]Jay Munro ---12/12/2013 02:21:31 PM---With scrollpathintoview, how does this sound for the two lines that used notional child: The scrollP

From: Jay Munro <jaymunro@microsoft.com>
To: Richard Schwerdtfeger/Austin/IBM@IBMUS
Cc: Rik Cabanier <cabanier@gmail.com>, Dominic Mazzoni <dmazzoni@google.com>, "eoconnor@apple.com" <eoconnor@apple.com>, Jatinder Mann <jmann@microsoft.com>, Canvas <public-canvas-api@w3.org>
Date: 12/12/2013 02:21 PM
Subject: RE: drawsystemfocusring/drawcustomfocusring

________________________________



With scrollpathintoview, how does this sound for the two lines that used notional child:


The scrollPathIntoView() method, when invoked, must run the following steps:

1.    Let the specified rectangle be the rectangle of the bounding box of the intended path.

2.    Let hidden child be an element that is a rendered child of the canvas element whose dimensions are those of the specified rectangle.

3.      Scroll the hidden child into view with the align to top flag set.



From: Richard Schwerdtfeger [mailto:schwer@us.ibm.com]
Sent: Thursday, December 12, 2013 11:07 AM
To: Jay Munro
Cc: Rik Cabanier; Dominic Mazzoni; eoconnor@apple.com; Jatinder Mann; Canvas
Subject: RE: drawsystemfocusring/drawcustomfocusring


Alright. fallback is safest then as that way we don't include other elements with display:none. We should also modify scrollpathintoview to refer to fallback content.

http://www.w3.org/TR/2012/CR-2dcontext-20121217/#dom-context-2d-scrollpathintoview

Do others agree?

Rich


Rich Schwerdtfeger

[Inactive hide details for Jay Munro ---12/11/2013 06:51:17 PM---Thanks Richard, I understand concept, as it’s essentially link]Jay Munro ---12/11/2013 06:51:17 PM---Thanks Richard, I understand concept, as it’s essentially linking an onscreen (canvas) element with

From: Jay Munro <jaymunro@microsoft.com<mailto:jaymunro@microsoft.com>>
To: Richard Schwerdtfeger/Austin/IBM@IBMUS
Cc: Rik Cabanier <cabanier@gmail.com<mailto:cabanier@gmail.com>>, Dominic Mazzoni <dmazzoni@google.com<mailto:dmazzoni@google.com>>, "eoconnor@apple.com<mailto:eoconnor@apple.com>" <eoconnor@apple.com<mailto:eoconnor@apple.com>>, Jatinder Mann <jmann@microsoft.com<mailto:jmann@microsoft.com>>, Canvas <public-canvas-api@w3.org<mailto:public-canvas-api@w3.org>>
Date: 12/11/2013 06:51 PM
Subject: RE: drawsystemfocusring/drawcustomfocusring

________________________________




Thanks Richard,

I understand concept, as it’s essentially linking an onscreen (canvas) element with a hidden element. As the hidden elements get focus, we highlight its partner image on the canvas, and supply whatever additional accessibility info or state from the hidden element.

By definition, “notional” is defined as imaginary, hypothetical, theoretical, or an idea. The fallback elements in Canvas have been termed the “shadow DOM”, but they are part of the DOM. If the browser doesn’t support Canvas, then the elements are shown. I’m hesitating to introduce a new term (notional child/children) as I’m not sure using it would make it clearer. I’d rather use “hidden” or “fallback elements” and see the action defined, than label them with a new term.

-Jay

>>
In canvas accessibility fallback elements (between canvas start and end tags) are used to represent important objects drawn on the physical canvas. These fallback elements are used in the keyboard navigation order and they supply accessibility information to the browser which will then in turn map that information to platform accessibility API services.

These fallback elements are considered to be "notional children" as they are not actually drawn to the glass as they are hidden by the canvas tag. However, because they are hidden we need a vehicle to provide their location to assistive technologies which these APIs do. For example, when we call drawSystemFocusRing(element):

The current path will get mapped to a bounding rectangle for the element in fallback content. Since these are notional children their location is not typically adjusted when the container they reside in scrolls. What we are saying is that when the page scrolls these "notional children" must also have their location adjusted the same way the canvas element location gets adjusted by the user agent.

When you are tabbing through the web page these fallback elements can be included in the tab order (e.g. tabindex="0"). When this occurs the canvas element may not be visible in the user agent due to the viewport of the browser. In this case (the same way we do with hyperlinks) the focus must be scrolled into view after the focus change occurs.

drawSystemFocusRing and drawCustomFocusRing are called by the author when a focus change occurs. I am not sure when the scroll would occur - after the focus event is fired in the DOM or before. Do you know?

Rich

Rich Schwerdtfeger

[Inactive hide details for Jay Munro ---12/10/2013 10:41:31 AM---Richard, On your inserted text below, are you thinking that wou]Jay Munro ---12/10/2013 10:41:31 AM---Richard, On your inserted text below, are you thinking that would be an addendum to the procedure li

From: Jay Munro <jaymunro@microsoft.com<mailto:jaymunro@microsoft.com>>
To: Richard Schwerdtfeger/Austin/IBM@IBMUS, Rik Cabanier <cabanier@gmail.com<mailto:cabanier@gmail.com>>
Cc: Dominic Mazzoni <dmazzoni@google.com<mailto:dmazzoni@google.com>>, Canvas <public-canvas-api@w3.org<mailto:public-canvas-api@w3.org>>, Jatinder Mann <jmann@microsoft.com<mailto:jmann@microsoft.com>>, "eoconnor@apple.com<mailto:eoconnor@apple.com>" <eoconnor@apple.com<mailto:eoconnor@apple.com>>
Date: 12/10/2013 10:41 AM
Subject: RE: drawsystemfocusring/drawcustomfocusring

________________________________





Richard,

On your inserted text below, are you thinking that would be an addendum to the procedure list or replacing some text?  I’m also wondering about the idea of a “notional child” and hypothetical elements. Are you talking about the ring itself or the element that the ring is highlighting when focused? I haven’t seen those phrases in documentation before.

-Jay



>> Richard said:

<rss>
drawSystemFocusRing() and drawCustomFocusRing() refer to a descendant of the canvas element. These descendants are each considered a notional child. Notional children are hypothetical elements that are rendered children of the canvas element and their dimensions are those of the bounding box of the specifed path.

When tabbing to a notional child, having an assigned location through the use of drawSystemFocusRing or drawCustomFocusRing, scroll the notional child into view following the steps defined by scrollPathIntoView.

When a canvas elements is scrolled as a result of being contained within an element having CSS stylle overscroll:scroll, notional children having an assigned location through the use of drawSystemFocusRing or drawCustomFocusRing, scroll the notional children bounds by the same change in position as the corresponding canvas element.

</rss>

>>