8000 [css3-ui] resolve mostly editorial issues 81,82,83. Ready for TR WD. · w3c/csswg-drafts@377f99f · GitHub
Skip to content

Commit 377f99f

Browse files
committed
[css3-ui] resolve mostly editorial issues 81,82,83. Ready for TR WD.
1 parent d15ca32 commit 377f99f

2 files changed

Lines changed: 27 additions & 38 deletions

File tree

css-ui/Overview.bs

Lines changed: 10 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,6 @@ Abstract: This specification describes user interface related selectors,
2222
Deadline: 2012-02-14
2323
Link Defaults: css-color-3 (property) color
2424
Link Defaults: selectors-4 (selector) :indeterminate
25-
Ignored Terms: style
26-
Ignored Terms: text
27-
Ignored Terms: default
2825
Ignored Terms: outline-top
2926
Ignored Terms: outline-left
3027
Ignored Terms: nav-index
@@ -508,15 +505,15 @@ The 'resize' property applies to elements
508505
whose computed 'overflow' value
509506
is something other than ''visible''.
510507

511-
The 'resize' property does not apply to generated content, the result is undefined.
508+
The effect of the 'resize' property on generated content is undefined. Implementation should not apply the 'resize' property to generated content.
512509

513-
Note: the 'resize' property may apply in the future if there is implementation of <a href="http://dev.w3.org/csswg/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a>.
510+
Note: the 'resize' property may apply to generated content in the future if there is implementation of <a href="http://dev.w3.org/csswg/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a>.
514511

515512
When an element is resized by the user,
516513
the user agent sets
517514
the 'width' and 'height' properties
518515
to px unit length values of the size indicated by the user,
519-
in the element’s 'style' attribute DOM,
516+
in the element’s <a spec="css-style-attr">style attribute</a> DOM,
520517
replacing existing property declaration(s) if any,
521518
without ''!important'' if any.
522519

@@ -532,24 +529,20 @@ and 'bottom' properties,
532529
whether the language of the element is right-to-left etc.
533530
The precise direction of resizing is left to the UA to properly determine for the platform.
534531

535-
The user agent should allow the user to resize the element
532+
The user agent must allow the user to resize the element
536533
with no other constraints than what is imposed by
537534
'min-width', 'max-width', 'min-height', and 'max-height'.
538-
(<a href="https://wiki.csswg.org/spec/css3-ui#issue-53">at risk</a>
535+
(The "must" is <a href="https://wiki.csswg.org/spec/css3-ui#issue-53">at risk</a>
539536
since
540-
<a href="http://lists.w3.org/Archives/Public/www-style/2014Dec/0063.html">only Firefox currently supports this</a>).
541-
542-
The user agent may restrict the resizing range to something suitable,
543-
such as between the original formatted size of the element,
544-
and large enough to encompass all the element's contents.
537+
<a href="http://lists.w3.org/Archives/Public/www-style/2014Dec/0063.html">only Firefox currently supports this</a>, and may be downgraded to a "should").
545538

546539
Note: There may be situations where user attempts to resize an element
547540
to appear to be overriden or ignored, e.g. because of ''!important'' cascading declarations that supersede
548-
that element’s 'style' attribute
541+
that element’s <a spec="css-style-attr">style attribute</a>
549542
'width' and 'height' properties in the DOM.
550543

551544
Changes to the computed value of an element's 'resize' property
552-
do not reset changes to the 'style' attribute made due to
545+
do not reset changes to the <a spec="css-style-attr">style attribute</a> made due to
553546
user resizing of that element.
554547

555548
<div class="example"><p style="display:none">Example(s):
@@ -640,8 +633,6 @@ for bidi purposes.
640633
</dd>
641634
</dl>
642635

643-
Note: The "[...] its block container element" detail of the "clip" value definition is at risk pending implementation and potentially web compatibility feedback.
644-
645636
Note: The <<string>> value, and the 2-value syntax "{1,2}"
646637
and functionality are all at risk.
647638

@@ -932,7 +923,7 @@ then only the end ellipsis/string should be rendered.
932923
This property specifies the type of cursor to be displayed for the pointing device
933924
when within the element's border-box.
934925

935-
The cursor property does not apply over native user-agent controls such as scrollbars, resizers, or other native UI widgets e.g. those that may be used inside some user agent specific implementations of form elements.
926+
User agents may ignore the cursor property over native user-agent controls such as scrollbars, resizers, or other native UI widgets e.g. those that may be used inside some user agent specific implementations of form elements.
936927

937928
Values have the following meanings:
938929

@@ -987,7 +978,7 @@ general purpose cursors
987978
<dl>
988979
<dt style="cursor:auto">auto</dt>
989980
<dd>The UA determines the cursor to display based on the current
990-
context, specifically: auto behaves as 'text' over text, and 'default' otherwise.
981+
context, specifically: auto behaves as ''cursor/text'' over text, and ''cursor/default'' otherwise.
991982

992983
<div>
993984
Issue: <a href="https://wiki.csswg.org/spec/css3-ui#issue-48">48</a> There are reports that this description of cursor: auto is insufficient and not interoperable. Current plan: restrict the auto value to handling things that cannot be described by the UA stylesheet, pending detailed proposal, likely based on <a href="https://lists.w3.org/Archives/Public/www-style/2013Jan/0275.html">David Baron's proposal</a>.

css-ui/Overview.html

Lines changed: 17 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -718,7 +718,7 @@
718718
<h1 class="p-name no-ref" id="title">CSS Basic User Interface Module Level 3 (CSS3 UI)</h1>
719719

720720
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft,
721-
<time class="dt-updated" datetime="2015-03-03">3 March 2015</time></span></h2>
721+
<time class="dt-updated" datetime="2015-03-04">4 March 2015</time></span></h2>
722722

723723
<div data-fill-with="spec-metadata">
724724
<dl>
@@ -2016,17 +2016,17 @@ <h3 class="heading settled" data-level="5.1" id="resize"><span class="secno">5.1
20162016
is something other than <a class="css" data-link-type="maybe" href="http://dev.w3.org/csswg/css-overflow-3/#valdef-overflow-visible">visible</a>.</p>
20172017

20182018

2019-
<p>The <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property does not apply to generated content, the result is undefined.</p>
2019+
<p>The effect of the <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property on generated content is undefined. Implementations should not apply the <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property to generated content.</p>
20202020

20212021

2022-
<p class="note" role="note">Note: the <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property may apply in the future if there is implementation of <a href="http://dev.w3.org/csswg/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a>.</p>
2022+
<p class="note" role="note">Note: the <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property may apply to generated content in the future if there is implementation of <a href="http://dev.w3.org/csswg/css-pseudo/#CSSPseudoElement-interface">Interface CSSPseudoElement</a>.</p>
20232023

20242024

20252025
<p>When an element is resized by the user,
20262026
the user agent sets
20272027
the <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-width">width</a> and <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-height">height</a> properties
20282028
to px unit length values of the size indicated by the user,
2029-
in the element’s <a class="property" data-link-type="propdesc">style</a> attribute DOM,
2029+
in the element’s <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-style-attr-1/#style-attribute">style attribute</a> DOM,
20302030
replacing existing property declaration(s) if any,
20312031
without <span class="css">!important</span> if any.</p>
20322032

@@ -2045,27 +2045,22 @@ <h3 class="heading settled" data-level="5.1" id="resize"><span class="secno">5.1
20452045
The precise direction of resizing is left to the UA to properly determine for the platform.</p>
20462046

20472047

2048-
<p>The user agent should allow the user to resize the element
2048+
<p>The user agent must allow the user to resize the element
20492049
with no other constraints than what is imposed by
20502050
<a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-min-width">min-width</a>, <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-max-width">max-width</a>, <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-min-height">min-height</a>, and <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-max-height">max-height</a>.
2051-
(<a href="https://wiki.csswg.org/spec/css3-ui#issue-53">at risk</a>
2051+
(The "must" is <a href="https://wiki.csswg.org/spec/css3-ui#issue-53">at risk</a>
20522052
since
2053-
<a href="http://lists.w3.org/Archives/Public/www-style/2014Dec/0063.html">only Firefox currently supports this</a>).</p>
2054-
2055-
2056-
<p>The user agent may restrict the resizing range to something suitable,
2057-
such as between the original formatted size of the element,
2058-
and large enough to encompass all the element’s contents.</p>
2053+
<a href="http://lists.w3.org/Archives/Public/www-style/2014Dec/0063.html">only Firefox currently supports this</a>, and may be downgraded to a "should").</p>
20592054

20602055

20612056
<p class="note" role="note">Note: There may be situations where user attempts to resize an element
20622057
to appear to be overriden or ignored, e.g. because of <span class="css">!important</span> cascading declarations that supersede
2063-
that element’s <a class="property" data-link-type="propdesc">style</a> attribute
2058+
that element’s <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-style-attr-1/#style-attribute">style attribute</a>
20642059
<a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-width">width</a> and <a class="property" data-link-type="propdesc" href="http://dev.w3.org/csswg/css2/visudet.html#propdef-height">height</a> properties in the DOM.</p>
20652060

20662061

20672062
<p>Changes to the computed value of an element’s <a class="property" data-link-type="propdesc" href="#propdef-resize">resize</a> property
2068-
do not reset changes to the <a class="property" data-link-type="propdesc">style</a> attribute made due to
2063+
do not reset changes to the <a data-link-type="dfn" href="http://dev.w3.org/csswg/css-style-attr-1/#style-attribute">style attribute</a> made due to
20692064
user resizing of that element.</p>
20702065

20712066

@@ -2199,9 +2194,6 @@ <h3 class="heading settled" data-level="5.2" id="text-overflow"><span class="sec
21992194
</dl>
22002195

22012196

2202-
<p class="note" role="note">Note: The "[...] its block container element" detail of the "clip" value definition is at risk pending implementation and potentially web compatibility feedback.</p>
2203-
2204-
22052197
<p class="note" role="note">Note: The <a class="production css" data-link-type="type" href="http://dev.w3.org/csswg/css-values-3/#string-value" title="Expands to: ">&lt;string></a> value, and the 2-value syntax "{1,2}"
22062198
and functionality are all at risk.</p>
22072199

@@ -2613,7 +2605,7 @@ <h4 class="heading settled" data-level="6.1.1" id="cursor"><span class="secno">6
26132605
when within the element’s border-box.
26142606

26152607

2616-
<p>The cursor property does not apply over native user-agent controls such as scrollbars, resizers, or other native UI widgets e.g. those that may be used inside 6D50 some user agent specific implementations of form elements.</p>
2608+
<p>User agents may ignore the cursor property over native user-agent controls such as scrollbars, resizers, or other native UI widgets e.g. those that may be used inside some user agent specific implementations of form elements.</p>
26172609

26182610

26192611
<p>Values have the following meanings:</p>
@@ -2685,7 +2677,7 @@ <h4 class="heading settled" data-level="6.1.1" id="cursor"><span class="secno">6
26852677
<dt style="cursor:auto">auto
26862678

26872679
<dd>The UA determines the cursor to display based on the current
2688-
context, specifically: auto behaves as <a class="property" data-link-type="propdesc">text</a> over text, and <a class="property" data-link-type="propdesc">default</a> otherwise.
2680+
context, specifically: auto behaves as <span class="css">text</span> over text, and <span class="css">default</span> otherwise.
26892681

26902682

26912683
<div>
@@ -4175,6 +4167,10 @@ <h3 class="no-num heading settled" id="index-defined-elsewhere"><span class="con
41754167
<li><a href="http://dev.w3.org/csswg/css-position-3/#propdef-bottom">bottom</a>
41764168
<li><a href="http://dev.w3.org/csswg/css-position-3/#propdef-right">right</a>
41774169
</ul>
4170+
<li><a data-link-type="biblio" href="#biblio-css-style-attr-1">[css-style-attr-1]</a> defines the following terms:
4171+
<ul>
4172+
<li><a href="http://dev.w3.org/csswg/css-style-attr-1/#style-attribute">style attribute</a>
4173+
</ul>
41784174
<li><a data-link-type="biblio" href="#biblio-css-values-3">[css-values-3]</a> defines the following terms:
41794175
<ul>
41804176
<li><a href="http://dev.w3.org/csswg/css-values-3/#length-value">&lt;length></a>
@@ -4235,6 +4231,8 @@ <h3 class="no-num heading settled" id="normative"><span class="content">Normativ
42354231
<dd>David Baron. <a href="http://www.w3.org/TR/css-overflow-3/">CSS Overflow Module Level 3</a>. 18 April 2013. WD. URL: <a href="http://www.w3.org/TR/css-overflow-3/">http://www.w3.org/TR/css-overflow-3/</a>
42364232
<dt id="biblio-css-position-3"><a class="self-link" href="#biblio-css-position-3"></a>[CSS-POSITION-3]
42374233
<dd>CSS Positioned Layout Module Level 3 URL: <a href="http://www.w3.org/TR/css3-positioning/">http://www.w3.org/TR/css3-positioning/</a>
4234+
<dt id="biblio-css-style-attr-1"><a class="self-link" href="#biblio-css-style-attr-1"></a>[CSS-STYLE-ATTR-1]
4235+
<dd>CSS Style Attributes Level 1 URL: <a href="http://www.w3.org/TR/css-style-attr/">http://www.w3.org/TR/css-style-attr/</a>
42384236
<dt id="biblio-css-values-3"><a class="self-link" href="#biblio-css-values-3"></a>[CSS-VALUES-3]
42394237
<dd>CSS Values and Units Module Level 3 URL: <a href="http://www.w3.org/TR/css3-values/">http://www.w3.org/TR/css3-values/</a>
42404238
<dt id="biblio-css-writing-modes-3"><a class="self-link" href="#biblio-css-writing-modes-3"></a>[CSS-WRITING-MODES-3]

0 commit comments

Comments
 (0)