Skip to content

Commit b3b6f70

Browse files
authored
Make "Using computed attribute values" normative (#256)
* Make "Using computed attribute values" normative Retain and reformat the example about non-DAPT functionality. * Address review feedback * Include this change in substantive-changes-summary.txt * Reword begin time paragraph in Using Computed Attribute Values As per review comment and discussion.
1 parent e098bac commit b3b6f70

File tree

2 files changed

+16
-13
lines changed

2 files changed

+16
-13
lines changed

index.html

+14-13
Original file line numberDiff line numberDiff line change
@@ -2548,25 +2548,23 @@ <h3>Handling <code>&lt;div&gt;</code> and <code>&lt;p&gt;</code> elements</h3>
25482548
</aside>
25492549
</section>
25502550

2551-
<section class="informative">
2551+
<section>
25522552
<h3>Using computed attribute values</h3>
2553-
<p><em>Some normative provisions relating to this section are defined in [[TTML2]].</em></p>
25542553
<p>Some attributes have semantics for computing their value that depend on the computed value of
25552554
the attribute on some other element.
25562555
For example if the <code>xml:lang</code> attribute is not specified on an element then its computed
25572556
value is the computed value of the same attribute on the element's parent.</p>
25582557
<p>Or, for another example, the computed times of an element in a DAPT document are relative
2559-
to the begin time of its parent element. If a <code>&lt;div&gt;</code> element specifies a <code>begin</code>
2560-
attribute, and that element does not correspond to a <a>Script Event</a>, then the computed times
2561-
of its descendant <code>&lt;div&gt;</code> elements that do correspond to <a>Script Events</a>
2562-
are different to what they would be if that intermediate <code>&lt;div&gt;</code> element's <code>begin</code>
2563-
time were ignored.</p>
2564-
<p class="ednote">MAYBE REMOVE Or, also for example, if styling is used in a TTML document, the computed value of the <code>tts:fontSize</code>
2565-
attribute when expressed as a percentage is relative to the computed value of the same attribute
2566-
on the element's parent.
2567-
Furthermore, in this example, the algorithm for generating ISDs (Intermediate Synchronic Documents)
2568-
involves reparenting some elements. The computed value that applies is the one <em>before</em>
2569-
rehoming has taken place.</p>
2558+
to the begin time of the element's parent.
2559+
If a <code>&lt;div&gt;</code> element specifies a <code>begin</code> attribute,
2560+
then the computed times of its child <code>&lt;div&gt;</code> elements
2561+
are relative to that parent <code>&lt;div&gt;</code> element's begin time,
2562+
and so on down the hierarchy.
2563+
It is important to include those &quot;intermediate&quot; <code>&lt;div&gt;</code> elements'
2564+
times in the computation even if the processing target is
2565+
an instance of the DAPT data model in which they have no direct equivalent;
2566+
otherwise the <a>Script Event</a> <a>Begin</a> and <a>End</a> times would be wrong.
2567+
</p>
25702568
<p>Considering this situation more generally,
25712569
it is possible that, within a DAPT document, there can be TTML elements that
25722570
do not directly correspond to objects in the DAPT data model,
@@ -2576,6 +2574,9 @@ <h3>Using computed attribute values</h3>
25762574
<p>The semantics defined by [[TTML2]] or, for vocabulary defined herein, this specification, take precedence in this scenario.
25772575
Implementations MUST compute attribute values based on the contents of the <a>document instance</a> <em>before</em>
25782576
applying those computed values to DAPT data model objects.
2577+
For example a processor that supports TTML2 styling features would need
2578+
to implement the TTML2 semantics for inheritance and computing relative values
2579+
of attributes like <code>tts:fontSize</code>.
25792580
</p>
25802581
<aside class="example">
25812582
<p>This example demonstrates these possibilities,

substantive-changes-summary.txt

+2
Original file line numberDiff line numberDiff line change
@@ -61,3 +61,5 @@ From FPWD (20230425)
6161
* At-risk: support for the `length` attribute on `<data>` PR-must-have (#224)
6262

6363
* At-risk: Script Event Grouping and Script Event Mapping PR-must-have (#239)
64+
65+
* Make "Using computed attribute values" normative (#249)

0 commit comments

Comments
 (0)