From 9dc6f8d78d52bc0e36ed97f206e55af7f940e2db Mon Sep 17 00:00:00 2001 From: Florian Rivoal Date: Thu, 9 Apr 2015 15:36:30 +0200 Subject: [PATCH 1/5] [css-ui] Fix all current bikeshed warnings --- css-ui/Overview.bs | 38 ++++++++++++------------ css-ui/Overview.html | 69 ++++++++++++++------------------------------ 2 files changed, 40 insertions(+), 67 deletions(-) diff --git a/css-ui/Overview.bs b/css-ui/Overview.bs index 45c084be6518..44f0a4b377a9 100644 --- a/css-ui/Overview.bs +++ b/css-ui/Overview.bs @@ -28,9 +28,7 @@ Link Defaults: css21 (property) max-width Link Defaults: css21 (property) max-height Ignored Terms: outline-top Ignored Terms: outline-left -Ignored Terms: nav-index Ignored Terms: ime-mode -Ignored Terms: icon At Risk: 'box-sizing' property value: padding-box At Risk: 'caret-color' property At Risk: 'text-overflow' property value: <> @@ -172,7 +170,7 @@ by legacy HTML user agents for replaced elements and input elements. Note: In contrast to the length and percentage values, -the ''auto'' value of the 'width' and 'height' properties +the ''width/auto'' value of the 'width' and 'height' properties (as well as other keyword values introduced by later specifications, unless otherwise specified) is not influenced by the 'box-sizing' property, @@ -191,7 +189,7 @@ The following terms, whose definitions vary based on the computed value of 'box- The Visual formatting model details of [[!CSS21]] are written assuming ''box-sizing: content-box''. The following disambiguations are made to clarify the behavior for all values of 'box-sizing':
    -
  1. In 10.3.3, the second width in the following phrase is to be interpreted as content width: If 'width' is not ''auto'' and 'border-left-width' + 'padding-left' + 'width' + [...] +
  2. In 10.3.3, the second width in the following phrase is to be interpreted as content width: If 'width' is not ''width/auto'' and 'border-left-width' + 'padding-left' + 'width' + [...]
  3. In 10.3.7, width is to be interpreted as content width in the following equation: 'left' + 'margin-left' + 'border-left-width' + 'padding-left' + 'width' + [...] @@ -304,7 +302,7 @@ The rendering of applying transforms to outlines is left explicitly undefined in Inherited:no Percentages:N/A Media:visual -Computed value:absolute length; ''0'' if the outline style is ''none''. +Computed value:absolute length; ''0'' if the outline style is ''outline-width/none''. Animatable:as length @@ -376,11 +374,11 @@ the same values as ([[!CSS3BG]], Section 4.2), except that -''hidden'' is not a legal outline style. +hidden is not a legal outline style. In addition, in CSS3, 'outline-style' -accepts the value ''auto''. -The ''auto'' value permits the user agent +accepts the value ''outline-style/auto''. +The ''outline-style/auto'' value permits the user agent to render a custom outline style, typically a style which is either a user interface default for the platform, or perhaps a style that is richer @@ -390,8 +388,8 @@ that appears to glow. As such, this specification does not define how the 'outline-color' is incorporated or used (if at all) when rendering -''auto'' style outlines. -User agents may treat ''auto'' as +''outline-style/auto'' style outlines. +User agents may treat ''outline-style/auto'' as ''solid''. The 'outline-color' property @@ -406,7 +404,7 @@ on platforms that do not support color inversion of the pixels on the screen. If the UA does not support the ''invert'' value then it must reject that value at parse-time, and the initial value of the 'outline-color' property -is the ''currentColor'' [[!CSS3COLOR]] keyword. +is the ''color/currentColor'' [[!CSS3COLOR]] keyword. The 'outline' property is a shorthand property, and sets all three of 'outline-style', @@ -563,7 +561,7 @@ When an element is resized by the user, the user agent sets the 'width' and 'height' properties to px unit length values of the size indicated by the user, -in the element’s style attribute DOM, +in the element’s style attribute DOM, replacing existing property declaration(s) if any, without ''!important'' if any. @@ -588,11 +586,11 @@ since Note: There may be situations where user attempts to resize an element to appear to be overriden or ignored, e.g. because of ''!important'' cascading declarations that supersede -that element’s style attribute +that element’s style attribute 'width' and 'height' properties in the DOM. Changes to the computed value of an element's 'resize' property -do not reset changes to the style attribute made due to +do not reset changes to the style attribute made due to user resizing of that element.

    Example(s): @@ -841,8 +839,8 @@ WON'T ELLIPSE.

    Note: the side of the line that the ellipsis is placed depends on the 'direction' of the block. E.g. an overflow hidden right-to-left (direction: rtl) -block clips inline content on the left side, -thus would place a text-overflow ellipsis on the left +block clips inline content on the left side, +thus would place a text-overflow ellipsis on the left to represent that clipped content. @@ -1155,7 +1153,7 @@ often rendered as a magnifying glass with a "+" or "-" in the center of the glas -The UA may treat unsupported values as ''auto''. +The UA may treat unsupported values as ''cursor/auto''. E.g. on platforms that do not have a concept of a ''context-menu'' cursor, the UA may render ''default'' or whatever is appropriate. @@ -1211,7 +1209,7 @@ boxes are generated for it and its cursor is used for the canvas. Inherited:no Percentages:N/A Media:interactive -Computed value:The computed value for ''auto'' is ''currentColor''. For <> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property. +Computed value:The computed value for ''caret-color/auto'' is ''color/currentColor''. For <> values, the computed value is as defined for the [[!CSS3COLOR]] 'color' property. Animatable:no @@ -1301,7 +1299,7 @@ For accessibility and user convenience, user agents should allow configuration of which keys on a keyboard are used for directional navigation.
    -
    Example: positioned buttons
    +
    Example: positioned buttons
    Here is an example of buttons positioned in a diamond shape whose directional focus navigation is set in such a way @@ -1342,7 +1340,7 @@ it is still important to ensure focus navigation behaviors which relate reasonab
    -
    Example: moving focus to inside a frame
    +
    Example: moving focus to inside a frame
    Moving the focus to an element in a specific frame requires both the element's id and the frame's name. diff --git a/css-ui/Overview.html b/css-ui/Overview.html index adbe599a232d..46c7301d4b8f 100644 --- a/css-ui/Overview.html +++ b/css-ui/Overview.html @@ -718,7 +718,7 @@

    CSS Basic User Interface Module Level 3 (CSS3 UI)

    Editor’s Draft, -

    +
    @@ -1079,7 +1079,7 @@

    Note: In contrast to the length and percentage values, -the auto value of the width and height properties +the auto value of the width and height properties (as well as other keyword values introduced by later specifications, unless otherwise specified) is not influenced by the box-sizing property, @@ -1129,7 +1129,7 @@

    -
  4. In 10.3.3, the second width in the following phrase is to be interpreted as content width: If width is not auto and border-left-width + padding-left + width + [...] +
  5. In 10.3.3, the second width in the following phrase is to be interpreted as content width: If width is not auto and border-left-width + padding-left + width + [...]
  6. In 10.3.7, width is to be interpreted as content width in the following equation: left + margin-left + border-left-width + padding-left + width + [...] @@ -1355,7 +1355,7 @@

    0 if the outline style is none. + absolute length; 0 if the outline style is none. @@ -1481,7 +1481,6 @@

    [CSS3BG], Section 4.2), except that -hidden is not a legal outline style. +hidden is not a legal outline style. In addition, in CSS3, outline-style -accepts the value auto. -The auto value permits the user agent +accepts the value auto. +The auto value permits the user agent to render a custom outline style, typically a style which is either a user interface default for the platform, or perhaps a style that is richer @@ -1833,8 +1833,8 @@

    outline-color is incorporated or used (if at all) when rendering -auto style outlines. -User agents may treat auto as +auto style outlines. +User agents may treat auto as solid.

    @@ -1852,7 +1852,7 @@

    invert value then it must reject that value at parse-time, and the initial value of the outline-color property -is the currentColor [CSS3COLOR] keyword.

    +is the currentColor [CSS3COLOR] keyword.

    The outline property is a shorthand property, @@ -2122,7 +2122,7 @@

    5.1 the user agent sets the width and height properties to px unit length values of the size indicated by the user, -in the element’s style attribute DOM, +in the element’s style attribute DOM, replacing existing property declaration(s) if any, without !important if any.

    @@ -2151,12 +2151,12 @@

    5.1

    Note: There may be situations where user attempts to resize an element to appear to be overriden or ignored, e.g. because of !important cascading declarations that supersede -that element’s style attribute +that element’s style attribute width and height properties in the DOM.

    Changes to the computed value of an element’s resize property -do not reset changes to the style attribute made due to +do not reset changes to the style attribute made due to user resizing of that element.

    @@ -2959,7 +2959,7 @@

    6

    7. -

    The UA may treat unsupported values as auto. +

    The UA may treat unsupported values as auto. E.g. on platforms that do not have a concept of a context-menu cursor, the UA may render default or whatever is appropriate.

    @@ -3077,7 +3077,6 @@

    auto is currentColor. For auto is currentColor. For user agents should allow configuration of which keys on a keyboard are used for directional navigation.

    -
    +
    6.3.1.1. Example: positioned buttons
    @@ -3710,7 +3710,7 @@
    -
    +
    6.3.1.2. Example: moving focus to inside a frame
    @@ -4217,14 +4217,6 @@

    Terms defined by reference

    -
  7. [css-color-4] defines the following terms: -
  8. [css-images-3] defines the following terms: -
  9. [css-style-attr-1] defines the following terms: -
  10. [css-values-3] defines the following terms:
    • <length> @@ -4327,26 +4310,18 @@

      Normativ
      Tantek Çelik; Chris Lilley; L. David Baron. CSS Color Module Level 3. 7 June 2011. W3C Recommendation. URL: http://www.w3.org/TR/2011/REC-css3-color-20110607
      [UAX29]
      Mark Davis. Text Boundaries. 25 March 2005. Unicode Standard Annex #29. URL: http://www.unicode.org/unicode/reports/tr29/tr29-9.html -
      [CSS-ALIGN-3] -
      Elika Etemad; Tab Atkins Jr.. CSS Box Alignment Module Level 3. 18 December 2014. WD. URL: http://www.w3.org/TR/css-align-3/ -
      [CSS-ANIMATIONS-1] -
      CSS Animations Module Level 1 URL: http://www.w3.org/TR/css3-animations/
      [CSS-BACKGROUNDS-3]
      CSS Backgrounds and Borders Module Level 3 URL: http://www.w3.org/TR/css3-background/
      [CSS-CASCADE-4]
      CSS Cascading and Inheritance Level 4 URL: http://dev.w3.org/csswg/css-cascade-4/
      [CSS-COLOR-3]
      CSS Color Module Level 3 URL: http://www.w3.org/TR/css3-color/ -
      [CSS-COLOR-4] -
      CSS Color Module Level 4 URL: http://dev.w3.org/csswg/css-color-4/
      [CSS-IMAGES-3]
      CSS Image Values and Replaced Content Module Level 3 URL: http://www.w3.org/TR/css3-images/
      [CSS-OVERFLOW-3]
      David Baron. CSS Overflow Module Level 3. 18 April 2013. WD. URL: http://www.w3.org/TR/css-overflow-3/
      [CSS-POSITION-3]
      CSS Positioned Layout Module Level 3 URL: http://www.w3.org/TR/css3-positioning/ -
      [CSS-STYLE-ATTR-1] -
      CSS Style Attributes Level 1 URL: http://www.w3.org/TR/css-style-attr/
      [CSS-VALUES-3]
      CSS Values and Units Module Level 3 URL: http://www.w3.org/TR/css3-values/
      [CSS-WRITING-MODES-3] From 88a43cf11cbd192d36f6b917c5a61ff4b82a0533 Mon Sep 17 00:00:00 2001 From: Florian Rivoal Date: Thu, 9 Apr 2015 16:46:27 +0200 Subject: [PATCH 2/5] [css-ui] Add missing markup/bikeshed --- css-ui/Overview.bs | 2 +- css-ui/Overview.html | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/css-ui/Overview.bs b/css-ui/Overview.bs index 44f0a4b377a9..a6bad230a95c 100644 --- a/css-ui/Overview.bs +++ b/css-ui/Overview.bs @@ -150,7 +150,7 @@ cannot be negative ([[!CSS21]], section 10.2), this computation is floored at 0. Used values, as exposed for instance through {{getComputedStyle()}}, also refer to the padding box. -
      border-box
      +
      border-box
      Length and percentages values for width and height (and respective min/max properties) on this element determine the border box of the element. That is, any padding or border specified on the element diff --git a/css-ui/Overview.html b/css-ui/Overview.html index 46c7301d4b8f..ef9f2743529e 100644 --- a/css-ui/Overview.html +++ b/css-ui/Overview.html @@ -1056,7 +1056,7 @@

      getComputedStyle(), also refer to the padding box. -
      border-box +
      border-box
      Length and percentages values for width and height (and respective min/max properties) on this element determine the border box of the element. @@ -2156,7 +2156,7 @@

      5.1

      Changes to the computed value of an element’s resize property -do not reset changes to the style attribute made due to +do not reset changes to the style attribute made due to user resizing of that element.

      @@ -4191,6 +4191,7 @@

      Index

      Terms defined by this specification

        +
      • border-box, 3.1
      • box-sizing, 3.1
      • caret-color, 6.2.1
      • clip, 5.2 From e02388c3558dcf53391597a35bb7f85098c1bcb7 Mon Sep 17 00:00:00 2001 From: Florian Rivoal Date: Thu, 9 Apr 2015 16:48:41 +0200 Subject: [PATCH 3/5] [css-ui] remove extraneous quotes --- css-ui/Overview.bs | 2 +- css-ui/Overview.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/css-ui/Overview.bs b/css-ui/Overview.bs index a6bad230a95c..460e20888f6e 100644 --- a/css-ui/Overview.bs +++ b/css-ui/Overview.bs @@ -538,7 +538,7 @@ to allow the user to adjust only the height of the element.

      Currently it is possible to control the appearance of the scrolling mechanism (if any) on an element using the 'overflow' property -(e.g. 'overflow: scroll' vs. 'overflow: hidden' etc.). +(e.g. overflow: scroll vs. overflow: hidden etc.). The purpose of the 'resize' property is to also allow control over the appearance and function of the resizing mechanism (e.g. a resize box or widget) on the element. diff --git a/css-ui/Overview.html b/css-ui/Overview.html index ef9f2743529e..6ec5b8d4c927 100644 --- a/css-ui/Overview.html +++ b/css-ui/Overview.html @@ -2094,7 +2094,7 @@

      5.1

      Currently it is possible to control the appearance of the scrolling mechanism (if any) on an element using the overflow property -(e.g. 'overflow: scroll' vs. 'overflow: hidden' etc.). +(e.g. overflow: scroll vs. overflow: hidden etc.). The purpose of the resize property is to also allow control over the appearance and function of the resizing mechanism (e.g. a resize box or widget) on the element.

      From 357fe0dd5219f154b3e3e8f29cc44cf9799f800a Mon Sep 17 00:00:00 2001 From: Florian Rivoal Date: Thu, 9 Apr 2015 17:01:51 +0200 Subject: [PATCH 4/5] [css-ui] Remove more extraneous quotes --- css-ui/Overview.bs | 2 +- css-ui/Overview.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/css-ui/Overview.bs b/css-ui/Overview.bs index 460e20888f6e..058cfcd22f07 100644 --- a/css-ui/Overview.bs +++ b/css-ui/Overview.bs @@ -657,7 +657,7 @@ that has 'overflow' other than ''visible''. Text can overflow for example when it is prevented from wrapping -(e.g. due to 'white-space: nowrap' +(e.g. due to white-space: nowrap or a single word is too long to fit). Values have the following meanings: diff --git a/css-ui/Overview.html b/css-ui/Overview.html index 6ec5b8d4c927..6c48ffd38d7f 100644 --- a/css-ui/Overview.html +++ b/css-ui/Overview.html @@ -2258,7 +2258,7 @@

      white-space: nowrap' +(e.g. due to white-space: nowrap or a single word is too long to fit). Values have the following meanings:

      From bababbd99723794c0a7869516b6364086adbb5bf Mon Sep 17 00:00:00 2001 From: Florian Rivoal Date: Thu, 9 Apr 2015 22:29:19 +0200 Subject: [PATCH 5/5] [css3-ui] Link to the css-style-attr REC rather than to the ED --- css-ui/Overview.bs | 6 +++--- css-ui/Overview.html | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/css-ui/Overview.bs b/css-ui/Overview.bs index 058cfcd22f07..ac8a665ffaed 100644 --- a/css-ui/Overview.bs +++ b/css-ui/Overview.bs @@ -561,7 +561,7 @@ When an element is resized by the user, the user agent sets the 'width' and 'height' properties to px unit length values of the size indicated by the user, -in the element’s style attribute DOM, +in the element’s style attribute DOM, replacing existing property declaration(s) if any, without ''!important'' if any. @@ -586,11 +586,11 @@ since Note: There may be situations where user attempts to resize an element to appear to be overriden or ignored, e.g. because of ''!important'' cascading declarations that supersede -that element’s style attribute +that element’s style attribute 'width' and 'height' properties in the DOM. Changes to the computed value of an element's 'resize' property -do not reset changes to the style attribute made due to +do not reset changes to the style attribute made due to user resizing of that element.

      Example(s): diff --git a/css-ui/Overview.html b/css-ui/Overview.html index 6c48ffd38d7f..c481abb57032 100644 --- a/css-ui/Overview.html +++ b/css-ui/Overview.html @@ -2122,7 +2122,7 @@

      5.1 the user agent sets the width and height properties to px unit length values of the size indicated by the user, -in the element’s style attribute DOM, +in the element’s style attribute DOM, replacing existing property declaration(s) if any, without !important if any.

      @@ -2151,12 +2151,12 @@

      5.1

      Note: There may be situations where user attempts to resize an element to appear to be overriden or ignored, e.g. because of !important cascading declarations that supersede -that element’s style attribute +that element’s style attribute width and height properties in the DOM.

      Changes to the computed value of an element’s resize property -do not reset changes to the style attribute made due to +do not reset changes to the style attribute made due to user resizing of that element.