ISSUE-380: The width of content elements' areas is unclear, especially looking at the examples

Content area width is unclear

The width of content elements' areas is unclear, especially looking at the examples

Raised by:
Nigel Megitt
Opened on:
The size of content elements relative to their parent elements and generated content elements is unclear. It is neither specified in §10.2.1 Style Attribute Vocabulary nor in §8.1 Content Element Vocabulary. It perhaps is specified in § Synchronic Flow Processing however there are no forward references directing the reader there. Even if it is in fact specified by a normative reference to XSL-FO and/or CSS, it would be helpful to add non-normative Notes where the information is most relevant, i.e. on style attributes whose effect is bounded by the applicable rectangular area.

The terms "block display", "inline display" and "inline block display" are usefully defined in TTML2 but those definitions are not referenced everywhere they apply.

Specifically, the implementation of the tts:backgroundColor, tts:backgroundImage and tts:border style attributes depends on the correct calculation of the rectangle to which they apply, and that rectangle is computed differently for spans than for the other content elements: only for spans is the size in the inline progression dimension related to the text content width; all the other elements' size in the inline progression dimension relates to the parent element's content rectangle minus any padding applied.

The example for tts:backgroundColor is ambiguous and possibly misleading in this respect, because the width of the text has been chosen to be exactly the same as the width of the content area of the p that is coloured purple, making it appear to the casual observer that the purple box is shrunk to the maximum width of the inline areas generated for the text.

Proposed resolutions:

1. EITHER include normative text that specifies how the calculation of the rectangle to which the above listed attributes apply differs between spans and other content elements OR (if somehow the normative text is already strong enough) add non-normative notes to each attribute calling out the difference, or add the note to the introductory part of §10.2 and then reference it from the attributes.

2. Add a diagram showing the width and height calculation (possibly this relates also to the resolution for Issue-302) that applies to each content element, and reference it from tts:backgroundColor, tts:backgroundImage and tts:border. This could be in the introductory part of §10.2 for example.

3. Change the example for tts:backgroundColor to make it use a longest line length that is shorter than the width of the content area of the parent p element, or add a new example or a second p where that is the case.

4. Ensure that the examples for tts:border do not reproduce the ambiguity.

Related Actions Items:
No related actions
Related emails:
  1. {minutes} TTWG Meeting 2015-04-02 (from on 2015-04-02)
  2. {agenda} TTWG Meeting 2015-04-02 (from on 2015-04-01)
  3. ISSUE-380 (Content area width is unclear): The width of content elements' areas is unclear, especially looking at the examples [TTML2] (from on 2015-03-26)

Related notes:

No additional notes.

Display change log ATOM feed

David Singer <>, Nigel Megitt <>, Chairs, Thierry Michel <>, Philippe Le Hégaret <>, Atsushi Shimono <>, Staff Contacts
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <>.
$Id: 380.html,v 1.1 2019/11/12 10:07:27 carcone Exp $