[Bug 15606] clarification of TextTrackCue.getCueAsHTML() conversion rules

https://www.w3.org/Bugs/Public/show_bug.cgi?id=15606

--- Comment #1 from Glenn Adams <glenn@skynav.com> 2012-01-18 16:55:33 UTC ---
(In reply to comment #0)
> In Section 4.8.10.12.5 Text track API, appears the following language:
> 
> "The getCueAsHTML() method must convert the text track cue text to a
> DocumentFragment for the media element's Document, using the appropriate rules
> for doing so. For example, for WebVTT, those rules are the WebVTT cue text
> parsing rules and the WebVTT cue text DOM construction rules. [WEBVTT]"
> 
> It would be useful to add clarifying information to the end of this paragraph
> (or in a new paragraph) as follows:
> 
> "Conversion rules for text track cue text other than WebVTT is expected to be
> defined by other specifications. If an HTML user agent does not recognize the
> text track cue format or does not support conversion rules specified for that
> format, then getCueAsHTML() should return a DocumentFragment containing a
> single Text node whose data attribute is identical to the text track cue text."

Alternatively in this new text, and perhaps better, would be:

"... should return null."

which would be a clear indication to script that the UA does not know or
support
conversion to HTML.

-- 
Configure bugmail: https://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Wednesday, 18 January 2012 16:55:40 UTC