Skip to content

Commit b421537

Browse files
committed
[cssom] Advisements are normative. Tweak wording to match CSSWG discussion and put it where it'll be noticed. w3c#3814
1 parent c1a685d commit b421537

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

cssom-1/Overview.bs

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -949,13 +949,9 @@ The <dfn method for=CSSStyleSheet>deleteRule(<var>index</var>)</dfn> method must
949949
<li><a>Remove a CSS rule</a> in the <a for=CSSStyleSheet>CSS rules</a> at <var>index</var>.
950950
</ol>
951951

952-
#### Legacy CSSStyleSheet members #### {#legacy-css-style-sheet-members}
952+
#### Deprecated CSSStyleSheet members #### {#legacy-css-style-sheet-members}
953953

954-
<p class=advisement>
955954
Note: These members are required for compatibility with existing sites.
956-
Authors are encouraged to use the standard members defined above instead,
957-
which are consistent with {{CSSGroupingRule}}.
958-
</p>
959955

960956
<pre class=idl>
961957
partial interface CSSStyleSheet {
@@ -982,6 +978,12 @@ The <dfn method for=CSSStyleSheet>addRule(<var>selector</var>, <var>block</var>,
982978
<li>Return <code>-1</code>.
983979
</ol>
984980

981+
<p class=advisement>
982+
Authors should not use these members
983+
and instead use and teach the standard {{CSSStyleSheet}} interface defined earlier,
984+
which is consistent with {{CSSGroupingRule}}.
985+
</p>
986+
985987
CSS Style Sheet Collections {#css-style-sheet-collections}
986988
----------------------------------------------------------
987989

0 commit comments

Comments
 (0)