Re: SVG Action 3728 and SVG Task force action 1582

Hi, Rich–

Sorry, I didn't mean for you to delay. I'm perfectly comfortable with 
using your text unless I find time to propose something else, and didn't 
mean to imply otherwise.

It's a spec. It can always be improved incrementally.

Regards–
–Doug

On 3/11/15 5:37 PM, Richard Schwerdtfeger wrote:
> Hi Doug,
>
> You wanted to try a different version of this text. I have not seen it
> yet. If I don't see it by Friday's call I will promote this to the SVG
> spec.
>
> It is accurate and what is there needs to be rewritten. We can always
> redo it later. You had also said this approach was acceptable on the
> last call.
>
> I also want to start rewriting the accessibility appendix which is also
> dated per our last meeting.
>
> Rich
>
>
> Rich Schwerdtfeger
>
> Inactive hide details for Richard Schwerdtfeger---02/16/2015 05:17:35
> PM---I took a pass at rewriting the <title> and <desc infRichard
> Schwerdtfeger---02/16/2015 05:17:35 PM---I took a pass at rewriting the
> <title> and <desc information in the SVG specification. Please review
>
> From: Richard Schwerdtfeger/Austin/IBM@IBMUS
> To: public-svg-a11y@w3.org
> Cc: "Erik Dahlstrom" <ed@opera.com>, "SVG public list" <www-svg@w3.org>,
> Fred Esch/Arlington/IBM@IBMUS
> Date: 02/16/2015 05:17 PM
> Subject: SVG Action 3728 and SVG Task force action 1582
>
> ------------------------------------------------------------------------
>
>
>
> I took a pass at rewriting the <title> and <desc information in the SVG
> specification. Please review for the SVG accessibility task force meeting.
>
> Associated actions:
>
> - _http://www.w3.org/Graphics/SVG/WG/track/actions/3728_
> - _https://www.w3.org/WAI/PF/Group/track/actions/1582_
>
> Here is a reference to the SVG title element text
> _
> __https://svgwg.org/svg2-draft/struct.html#TitleElement_
> *
> Current text and logged issues:*
>
> Each _container element_
> <https://svgwg.org/svg2-draft/struct.html#TermContainerElement> or
> _graphics element_
> <https://svgwg.org/svg2-draft/struct.html#TermGraphicsElement> in an SVG
> drawing can supply one or more ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ and/or one or
> more ‘_title_ <https://svgwg.org/svg2-draft/struct.html#TitleElement>’
> description strings where the description is text-only. When the current
> SVG document fragment is rendered as SVG on visual media, ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ and ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ elements are
> not rendered as part of the graphics. User agents may, however, for
> example, display the ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ element as a
> tooltip, as the pointing device moves over particular elements.
> Alternate presentations are possible, both visual and aural, which
> display the ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ and ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ elements but do
> not display ‘_path_
> <https://svgwg.org/svg2-draft/paths.html#PathElement>’ elements or other
> _graphics elements_
> <https://svgwg.org/svg2-draft/struct.html#TermGraphicsElement>. This is
> readily achieved by using a different (perhaps user) style sheet. For
> deep hierarchies, and for following ‘_use_
> <https://svgwg.org/svg2-draft/struct.html#UseElement>’ element
> references, it is sometimes desirable to allow the user to control how
> deep they drill down into descriptive text.
>
>
> Authors should always provide a ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ child element
> to the _outermost svg element_
> <https://svgwg.org/svg2-draft/struct.html#TermOutermostSVGElement> within a
> stand-alone SVG document. The ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ child element
> to an ‘_svg_ <https://svgwg.org/svg2-draft/struct.html#SVGElement>’
> element serves the purposes of identifying the content of the given SVG
> document fragment. Since users often consult documents out of context,
> authors should provide context-rich titles. Thus, instead of a title
> such as "Introduction", which doesn't provide much contextual
> background, authors should supply a title such as "Introduction to
> Medieval Bee-Keeping" instead. For reasons of accessibility, user agents
> should always make the content of the ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ child element
> to the _outermost svg element_
> <https://svgwg.org/svg2-draft/struct.html#TermOutermostSVGElement> available
> to users. The mechanism for doing so depends on the user agent (e.g., as
> a caption, spoken).
>
> Issue: We have this sentence here about tooltips which is stronger than
> the earlier note that some implementations do this. We should look at
> how HTML describes the ‘title’ attribute and whether a tooltip is
> required, suggested, etc., and follow that.
>
> Issue: Once we have said how ARIA attributes can be used in SVG, we
> might want to define ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ and ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ in a manner
> consistent with them, so that it is clear what it means for example for
> an element to have both a ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ element child
> and an ‘aria-describedby’ attribute.
>
> Proposed text:
>
> Each _container element_
> <https://svgwg.org/svg2-draft/struct.html#TermContainerElement> or
> _graphics element_
> <https://svgwg.org/svg2-draft/struct.html#TermGraphicsElement> in an SVG
> drawing can supply one or more ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ and/or one or
> more ‘_title_ <https://svgwg.org/svg2-draft/struct.html#TitleElement>’
> description strings where the description is text-only. When the current
> SVG document fragment is rendered as SVG on visual media, ‘_desc_
> <https://svgwg.org/svg2-draft/struct.html#DescElement>’ and ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ elements are
> not rendered as part of the graphics. The *'title' child* element
> _represents_ <http://www.w3.org/TR/html5/dom.html#represents> advisory
> information for the element, such as would be appropriate for a tooltip.
> On a link, this could be the title or a description of the target
> resource; on an image or drawing object, it could be the image credit or
> short description of the image; it could be further information about
> the source; on _interactive content_
> <http://www.w3.org/TR/html5/dom.html#interactive-content-0>, it could be
> a label for, or instructions for, use of the element; and so forth. The
> value is text. The *'desc*' element _represents_
> <http://www.w3.org/TR/html5/dom.html#represents> more detailed, textual
> information, for the element. This is typically exposed to assistive
> technologies to provide more detailed information, such as help
> information about the element. The value is text.
>
> Authors are provided two vehicles for providing a visible label with a
> drawing element. The first way is to embed text within the drawing
> element. The second is to associate visible text with a drawing element
> through the use of aria-labelledby on the element being labelled.
> Authors may provide a non-visible label to a drawing element by applying
> an aria-label to it but also by providing a descendant <title> element.
> An author may also expose a hidden label on an element to an assistive
> technologies through the use of aria-labelledby when it points to
> content that is hidden and contains text. It is common for user agents
> to render the <title> element as a tooltip. Tooltips are an important
> way to convey alternative text information for a drawing object where
> the text label is either not readily visible or could be rendered in a
> clearer way in response to passing over the drawing element with a
> pointing device. One benefit of using a descendant 'title' element can
> be seen when using SVG to to produce an image button or small drawing
> that has no visible text but it is important to be able to render a
> short textual equivalent label, or tooltip, when a pointing device
> passes over the button.
>
> Authors should provide a ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ child element
> to the _outermost svg element_
> <https://svgwg.org/svg2-draft/struct.html#TermOutermostSVGElement> within a
> stand-alone SVG document. Since users often consult documents out of
> context, authors should provide context-rich titles. Thus, instead of a
> title such as "Introduction", which doesn't provide much contextual
> background, authors should supply a title such as "Introduction to
> Medieval Bee-Keeping" instead. For reasons of accessibility, user agents
> should always make the content of the ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ child element
> to the _outermost svg element_
> <https://svgwg.org/svg2-draft/struct.html#TermOutermostSVGElement> available
> to users. The mechanism for doing so depends on the user agent (e.g., as
> a caption, spoken).
>
> If the SVG document is embedded in an HTML document, the _outermost svg
> element_
> <https://svgwg.org/svg2-draft/struct.html#TermOutermostSVGElement> may
> only serve to act as a container for SVG drawings and applying a 'title'
> child element may not be of value.  Applying a 'title" element to the
> outermost SVG element in this may may result in a tooltip being generated.
>
> Unlike the desc element, authors also have the ability to associate more
> detailed information with content that includes visible text. This can
> be achieved by applying aria-describedby to the element, or container of
> elements being described and passing an ID reference to content that
> includes text that describes the element in question. However, if the
> text describing the object is hidden the text within the description
> would be exposed to assistive technologies as detailed text information,
> similar to a descendant 'desc' element.
>
> Both visual and aural Alternative renderings of ‘_title_
> <https://svgwg.org/svg2-draft/struct.html#TitleElement>’ element or
> 'desc' element are possible through the use of style sheets.
>
> Rich
>

Received on Thursday, 12 March 2015 20:39:10 UTC