[css-scroll-snap] Rename scroll-snap-margin to scroll-margin per WG resolution.

Author: fantasai

css-scroll-snap-1/Overview.bs

@@ -212,7 +212,7 @@ Overview {#overview}
     <a>Snap positions</a> are specified
     as a particular alignment ('scroll-snap-align')
     of an element’s <a>scroll snap area</a>
-    (its border bounding box, as modified by 'scroll-snap-margin')
+    (its border bounding box, as modified by 'scroll-margin')
     within the <a>scroll container</a>’s <a>snapport</a>
     (its scrollport, as reduced by 'scroll-padding').
     This is conceptually equivalent to specifying the alignment of
@@ -484,11 +484,11 @@ Aligning Scroll Snap Areas:  Properties on the elements {#properties-on-the-elem
 ██     ██ ██     ██ ████████ ██     ██
 -->
 
-Scroll Snapping Area: the 'scroll-snap-margin' property {#scroll-snap-margin}
------------------------------------------------------------------------------
+Scroll Snapping Area: the 'scroll-margin' property {#scroll-margin}
+-------------------------------------------------------------------
 
     <pre class="propdef">
-    Name: scroll-snap-margin
+    Name: scroll-margin
     Value: <<length>>{1,4}
     Initial: 0
     Applies to: all elements
@@ -500,7 +500,7 @@ Scroll Snapping Area: the 'scroll-snap-margin' property {#scroll-snap-margin}
     </pre>
 
     This property is a <a>shorthand property</a> that sets
-    all of the <a href="#longhands"><css>scroll-snap-margin-*</css> longhands</a>
+    all of the <a href="#longhands"><css>scroll-margin-*</css> longhands</a>
     in one declaration,
     assigning values to the longhands representing each side
     exactly as the 'margin' property does for its longhands.
@@ -1008,11 +1008,11 @@ Flow-relative Longhands for 'scroll-padding'  {#padding-longhands-logical}
     If two values are specified, the first gives the start value
     and the second gives the end value.
 
-Physical Longhands for 'scroll-snap-margin'  {#margin-longhands-physical}
--------------------------------------------------------------------------
+Physical Longhands for 'scroll-margin'  {#margin-longhands-physical}
+--------------------------------------------------------------------
 
     <pre class="propdef">
-    Name: scroll-snap-margin-top, scroll-snap-margin-right, scroll-snap-margin-bottom, scroll-snap-margin-left
+    Name: scroll-margin-top, scroll-margin-right, scroll-margin-bottom, scroll-margin-left
     Value: <<length>>
     Initial: 0
     Applies to: all elements
@@ -1023,15 +1023,15 @@ Physical Longhands for 'scroll-snap-margin'  {#margin-longhands-physical}
     Animatable: as length
     </pre>
 
-    These <a>longhands</a> of 'scroll-snap-margin' specify
+    These <a>longhands</a> of 'scroll-margin' specify
     the top, right, bottom, and left edges
     of the <a>scroll snap area</a>, respectively.
 
-Flow-relative Longhands for 'scroll-snap-margin'  {#margin-longhands-logical}
------------------------------------------------------------------------------
+Flow-relative Longhands for 'scroll-margin'  {#margin-longhands-logical}
+------------------------------------------------------------------------
 
     <pre class="propdef">
-    Name: scroll-snap-margin-block-start, scroll-snap-margin-inline-start, scroll-snap-margin-block-end, scroll-snap-margin-inline-end
+    Name: scroll-margin-block-start, scroll-margin-inline-start, scroll-margin-block-end, scroll-margin-inline-end
     Value: <<length>>
     Initial: 0
     Applies to: all elements
@@ -1042,12 +1042,12 @@ Flow-relative Longhands for 'scroll-snap-margin'  {#margin-longhands-logical}
     Animatable: as length
     </pre>
 
-    These <a>longhands</a> of 'scroll-snap-margin' specify the
+    These <a>longhands</a> of 'scroll-margin' specify the
     block-start, inline-start, block-end, and inline-end edges
     of the <a>scroll snap area</a>, respectively.
 
     <pre class="propdef">
-    Name: scroll-snap-margin-block, scroll-snap-margin-inline
+    Name: scroll-margin-block, scroll-margin-inline
     Value: <<length>>{1,2}
     Initial: 0
     Applies to: all elements
@@ -1058,9 +1058,9 @@ Flow-relative Longhands for 'scroll-snap-margin'  {#margin-longhands-logical}
     Animatable: as length
     </pre>
 
-    These <a>shorthands</a> of 'scroll-snap-margin-block-start' + 'scroll-snap-margin-block-end'
-    and 'scroll-snap-margin-inline-start' + 'scroll-snap-margin-inline-end'
-    are <a>longhands</a> of 'scroll-snap-margin',
+    These <a>shorthands</a> of 'scroll-margin-block-start' + 'scroll-margin-block-end'
+    and 'scroll-margin-inline-start' + 'scroll-margin-inline-end'
+    are <a>longhands</a> of 'scroll-margin',
     and specify the block-axis and inline-axis edges
     of the <a>scroll snap area</a>, respectively.
 
@@ -1097,10 +1097,13 @@ Changes Since 24 August 2017 CR {#changes-20170824}
 
     Changes since the <a href="https://www.w3.org/TR/2017/CR-css-scroll-snap-1-20170824/">24 August 2017 Candidate Recommendation</a> include:
 
-    * '':target''/{{scrollIntoView()}}/etc must use snap positions if snapping is turned on,
-        and may use them even if it's off.
-    * '':target''/{{scrollIntoView()}}/etc should take 'scroll-snap-margin' into account,
-        regardless of whether snapping is turned on or not.
+	* '':target''/{{scrollIntoView()}}/etc should take 'scroll-margin' into account,
+		regardless of whether snapping is turned on or not.
+	* '':target''/{{scrollIntoView()}}/etc must (rather than should)
+		use snap positions if snapping is turned on.
+	* Renamed <css>scroll-snap-margin</css> to 'scroll-margin'
+		to reflect its more generic role in providing breathing space
+		for scrolling to an element regardless of snapping behavior.
 
 Changes Since 20 October 2016 CR {#changes-20161020}
 ----------------------------------------------------
@@ -1126,7 +1129,7 @@ Changes Since 20 October 2016 CR {#changes-20161020}
                 may push off-screen the [=snap area=] that the other axis would otherwise align to,
                 making its [=snap position=] invalid and therefore unchooseable.</p></ins>
 			</blockquote>
-		<li>Clarified how the 'scroll-padding' and 'scroll-snap-margin' shorthands
+		<li>Clarified how the 'scroll-padding' and 'scroll-margin' shorthands
 			assign values to their longhands.
 			(<a href="https://github.com/w3c/csswg-drafts/issues/1050">Issue 1050</a>)
 		<li>Clarified that scroll snapping does not mandate any particular input method.

css-scroll-snap-1/issues-cr-2016-08.bsi

@@ -33,5 +33,6 @@ Issue 4.
 Summary:  Rename scroll-snap-margin to scroll-margin?
 From:     Alan Stearns
 Comment:  https://github.com/w3c/csswg-drafts/issues/1954
-Open:     =WG= Discuss.
+Closed:   Accepted
+Resolved: Telecon 2017-12-06
 ----