Skip to content

Commit fcf0a97

Browse files
committed
[css-overflow] Stop trying to use "computed style" as a term for all computed values.
1 parent 1b72d6a commit fcf0a97

2 files changed

Lines changed: 34 additions & 28 deletions

File tree

css-transitions/Overview.bs

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -569,39 +569,41 @@ url: http://w3c.github.io/dom/#constructing-events; type: dfn; text: event const
569569
</div>
570570

571571
<p>
572-
Various things can cause the computed style of an element to change,
573-
or for an element to start or stop having computed style.
572+
Various things can cause the <a>computed values</a> of properties
573+
on an element to change.
574574
These include
575575
insertion and removal of elements from the document tree
576-
(which both changes whether those elements have computed styles and
576+
(which both changes whether those elements have <a>computed values</a> and
577577
can change the styles of other elements through selector matching),
578578
changes to the document tree that cause
579579
changes to which selectors match elements,
580580
changes to style sheets or style attributes,
581581
and other things.
582-
This specification does not define when computed styles are updated,
582+
This specification does not define when <a>computed values</a> are updated,
583583
beyond saying that implementations must not
584584
use, present, or display something resulting from the CSS
585585
cascading, value computation, and inheritance process [[!CSS3CASCADE]]
586-
without updating the computed style
586+
without updating the <a>computed value</a>
587587
(which means merely that implementations cannot avoid
588588
meeting requirements of this specification
589-
by claiming not to have updated the computed style
589+
by claiming not to have updated the <a>computed value</a>
590590
as part of handling a style change).
591591
However,
592-
when an implementation updates the computed style for an element
592+
when an implementation updates the <a>computed value</a> of a
593+
property on an element
593594
to reflect one of these changes,
594-
or computes the computed style for an element
595+
or computes the <a>computed value</a> of a property on an element
595596
newly added to the document,
596-
it must update the computed style for all elements to reflect all
597+
it must update the <a>computed value</a>
598+
for all properties and elements to reflect all
597599
of these changes at the same time
598600
(or at least it must be undetectable that it was done at a
599601
different time).
600602
This processing of a set of simultaneous style changes is called a
601603
<dfn>style change event</dfn>.
602604
(Implementations typically have a <a>style change event</a> to
603605
correspond with their desired screen refresh rate,
604-
and when up-to-date computed style is needed
606+
and when up-to-date computed style or layout information is needed
605607
for a script API that depends on it.)
606608
</p>
607609

@@ -619,23 +621,24 @@ url: http://w3c.github.io/dom/#constructing-events; type: dfn; text: event const
619621
<p>
620622
When a <a>style change event</a> occurs,
621623
implementations must start transitions based on
622-
the computed styles that changed in that event.
624+
the <a>computed values</a> that changed in that event.
623625
If an element is not in the document during that
624626
style change even or was not in the document during
625627
the previous style change event,
626628
then transitions are not started for that element
627629
in that style change event.
628630
Otherwise,
629631
define the <dfn>before-change style</dfn> as
630-
the computed style for the element as of
632+
the <a>computed values</a> of all properties on the element as of
631633
the previous <a>style change event</a>,
632634
except with any styles derived from declarative
633635
animations such as CSS Transitions, CSS Animations
634636
([[CSS3-ANIMATIONS]]),
635637
and SMIL Animations ([[SMIL-ANIMATION]], [[SVG11]])
636638
updated to the current time.
637639
Likewise, define the <dfn>after-change style</dfn> as
638-
the computed style for the element based on the information
640+
the <a>computed values</a> of all properties
641+
on the element based on the information
639642
known at the start of that <a>style change event</a>,
640643
but excluding any styles from CSS Transitions in the computation,
641644
and inheriting from
@@ -1618,7 +1621,7 @@ dated 19 November 2013</a>:</p>
16181621
<li>The interpolation of ''shadow/inset'' values on shadow lists is no longer backwards.</li>
16191622
<li>A [[#conformance]] section and [[#idl-index]] have been added</li>
16201623
<li>The identifiers accepted by 'transition-property' are defined in terms of <<custom-ident>>.</li>
1621-
<li>Define a little bit more about when changes to computed style happen, by saying at least that implementations must not update the effects of computed style without actually updating computed style.</li>
1624+
<li>Define a little bit more about when changes to computed values happen, by saying at least that implementations must not update the effects of computed values without actually updating computed values.</li>
16221625
</ul>
16231626

16241627
<p>For more details on these changes, see the version control <a href="https://hg.csswg.org/drafts/log/tip/css-transitions/Overview.bs">change log since 2015 January 26</a> and the <a href="https://hg.csswg.org/drafts/log/tip/css-transitions/Overview.src.html">change log from 2013 March 28 to 2015 January 26</a>.</p>

css-transitions/Overview.html

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -960,39 +960,41 @@ <h2 class="heading settled" data-level="3" id="starting"><span class="secno">3.
960960

961961

962962
<p>
963-
Various things can cause the computed style of an element to change,
964-
or for an element to start or stop having computed style.
963+
Various things can cause the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> of properties
964+
on an element to change.
965965
These include
966966
insertion and removal of elements from the document tree
967-
(which both changes whether those elements have computed styles and
967+
(which both changes whether those elements have <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> and
968968
can change the styles of other elements through selector matching),
969969
changes to the document tree that cause
970970
changes to which selectors match elements,
971971
changes to style sheets or style attributes,
972972
and other things.
973-
This specification does not define when computed styles are updated,
973+
This specification does not define when <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> are updated,
974974
beyond saying that implementations must not
975975
use, present, or display something resulting from the CSS
976976
cascading, value computation, and inheritance process <a data-link-type="biblio" href="#biblio-css3cascade">[CSS3CASCADE]</a>
977-
without updating the computed style
977+
without updating the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed value</a>
978978
(which means merely that implementations cannot avoid
979979
meeting requirements of this specification
980-
by claiming not to have updated the computed style
980+
by claiming not to have updated the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed value</a>
981981
as part of handling a style change).
982982
However,
983-
when an implementation updates the computed style for an element
983+
when an implementation updates the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed value</a> of a
984+
property on an element
984985
to reflect one of these changes,
985-
or computes the computed style for an element
986+
or computes the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed value</a> of a property on an element
986987
newly added to the document,
987-
it must update the computed style for all elements to reflect all
988+
it must update the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed value</a>
989+
for all properties and elements to reflect all
988990
of these changes at the same time
989991
(or at least it must be undetectable that it was done at a
990992
different time).
991993
This processing of a set of simultaneous style changes is called a
992994
<dfn data-dfn-type="dfn" data-noexport="" id="style-change-event">style change event<a class="self-link" href="#style-change-event"></a></dfn>.
993995
(Implementations typically have a <a data-link-type="dfn" href="#style-change-event">style change event</a> to
994996
correspond with their desired screen refresh rate,
995-
and when up-to-date computed style is needed
997+
and when up-to-date computed style or layout information is needed
996998
for a script API that depends on it.)
997999
</p>
9981000

@@ -1012,23 +1014,24 @@ <h2 class="heading settled" data-level="3" id="starting"><span class="secno">3.
10121014
<p>
10131015
When a <a data-link-type="dfn" href="#style-change-event">style change event</a> occurs,
10141016
implementations must start transitions based on
1015-
the computed styles that changed in that event.
1017+
the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> that changed in that event.
10161018
If an element is not in the document during that
10171019
style change even or was not in the document during
10181020
the previous style change event,
10191021
then transitions are not started for that element
10201022
in that style change event.
10211023
Otherwise,
10221024
define the <dfn data-dfn-type="dfn" data-noexport="" id="before_change-style">before-change style<a class="self-link" href="#before_change-style"></a></dfn> as
1023-
the computed style for the element as of
1025+
the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> of all properties on the element as of
10241026
the previous <a data-link-type="dfn" href="#style-change-event">style change event</a>,
10251027
except with any styles derived from declarative
10261028
animations such as CSS Transitions, CSS Animations
10271029
(<a data-link-type="biblio" href="#biblio-css3-animations">[CSS3-ANIMATIONS]</a>),
10281030
and SMIL Animations (<a data-link-type="biblio" href="#biblio-smil-animation">[SMIL-ANIMATION]</a>, <a data-link-type="biblio" href="#biblio-svg11">[SVG11]</a>)
10291031
updated to the current time.
10301032
Likewise, define the <dfn data-dfn-type="dfn" data-noexport="" id="after_change-style">after-change style<a class="self-link" href="#after_change-style"></a></dfn> as
1031-
the computed style for the element based on the information
1033+
the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-cascade-3/#computed-value">computed values</a> of all properties
1034+
on the element based on the information
10321035
known at the start of that <a data-link-type="dfn" href="#style-change-event">style change event</a>,
10331036
but excluding any styles from CSS Transitions in the computation,
10341037
and inheriting from
@@ -2447,7 +2450,7 @@ <h2 class="heading settled" data-level="9" id="changes"><span class="secno">9. <
24472450

24482451
<li>The identifiers accepted by <a class="property" data-link-type="propdesc" href="#propdef-transition-property">transition-property</a> are defined in terms of <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#identifier-value">&lt;custom-ident></a>.
24492452

2450-
<li>Define a little bit more about when changes to computed style happen, by saying at least that implementations must not update the effects of computed style without actually updating computed style.
2453+
<li>Define a little bit more about when changes to computed values happen, by saying at least that implementations must not update the effects of computed values without actually updating computed values.
24512454
</ul>
24522455

24532456

0 commit comments

Comments
 (0)