From dcd314f87e5c5d7172c3a3c2cb067bd518370bd2 Mon Sep 17 00:00:00 2001 From: SebastianZ Date: Fri, 24 Jun 2016 11:55:39 +0200 Subject: [PATCH] [css-backgrounds-4] Bikeshed improvements related to property values (fixes #138) --- css-backgrounds-4/Overview.bs | 141 +++++++++------------------------- 1 file changed, 37 insertions(+), 104 deletions(-) diff --git a/css-backgrounds-4/Overview.bs b/css-backgrounds-4/Overview.bs index 0d364ad1e0b..baaee3b6aba 100644 --- a/css-backgrounds-4/Overview.bs +++ b/css-backgrounds-4/Overview.bs @@ -31,15 +31,9 @@ Backgrounds

Background Positioning: the 'background-position' shorthand property

- 
+	
 		Name: background-position
 		Value: <>#
-		Initial: top left
-		Applies to: all
-		Inherited: no
-		Percentages: refer to size of background positioning area minus size of background image
-		Media: visual
-		Computed value: A list, each item consisting of: a pair of offsets and an origin, each offset given as a combination of an absolute length and a percentage
 	

 
 	See [[CSS3BG]] for definition.
@@ -86,56 +80,48 @@ Background Positioning Longhands: the 'background-position-x', 'background-posit
 
 	Issue: This section is still being worked out. The tricky thing is making all the start/end keywords work sanely.
 
-	
+	
 		Name: background-position-x
-		Value: [ center | [ left | right | x-start | x-end ]? [ <percentage> | <length> ]? ]#
+		Value: [ center | [ left | right | x-start | x-end ]? <>? ]#
 		Initial: left
-		Applies to: all
 		Inherited: no
 		Percentages: refer to width of background positioning area minus width of background image
-		Media: visual
 		Computed value: A list, each item consisting of: an offset given as a combination of an absolute length and a percentage, plus an origin keyword
 	

 
 	This property specifies the background position's horizontal component.
 	An omitted origin keyword is assumed to be ''left''.
 
-	
+	
 		Name: background-position-y
-		Value: [ center | [ top | bottom | y-start | y-end ]? [ <percentage> | <length> ]? ]#
+		Value: [ center | [ top | bottom | y-start | y-end ]? <>? ]#
 		Initial: left
-		Applies to: all
 		Inherited: no
 		Percentages: refer to height of background positioning area minus height of background image
-		Media: visual
 		Computed value: A list, each item consisting of: an offset given as a combination of an absolute length and a percentage, plus an origin keyword
 	

 
 	This property specifies the background position's vertical component.
 	An omitted origin keyword is assumed to be ''top''.
 
-	
+	
 		Name: background-position-inline
-		Value: [ center | [ start | end ]? [ <percentage> | <length> ]? ]#
+		Value: [ center | [ start | end ]? <>? ]#
 		Initial: not applicable (initial value comes from physical property)
-		Applies to: all
 		Inherited: no
 		Percentages: refer to inline-size of background positioning area minus inline-size of background image
-		Media: visual
 		Computed value: A list, each item consisting of: an offset given as a combination of an absolute length and a percentage, plus an origin keyword
 	

 
 	This property specifies the background position's inline-axis component.
 	An omitted origin keyword is assumed to be ''background-position-inline/start''.
 
-	
+	
 		Name: background-position-block
-		Value: [ center | [ start | end ]? [ <percentage> | <length> ]? ]#
+		Value: [ center | [ start | end ]? <>? ]#
 		Initial: not applicable (initial value comes from physical property)
-		Applies to: all
 		Inherited: no
 		Percentages: refer to size of background positioning area minus size of background image
-		Media: visual
 		Computed value: A list, each item consisting of: an offset given as a combination of an absolute length and a percentage, plus an origin keyword
 	

 
@@ -148,17 +134,12 @@ Corners
 

 Corner Sizing: the 'border-radius property

 
-	
-		Name:            border-radius
-		Value:           [ <> | <> ]{1,4} [ / [ <> | <> ]{1,4} ]?
-		Initial:         0
-		Applies to:      all elements, except table element when 'border-collapse' is ''collapse''
-		Inherited:       no
-		Percentages:     n/a
-		Media:           visual
-		Computed value:  specified value
-		Animatable:      no
-		Canonical order: n/a
+	
+		Name: border-radius
+		Value: <>{1,4} [ / <>{1,4} ]?
+		Initial: 0
+		Applies to: all elements, except table element when 'border-collapse' is ''collapse''
+		Inherited: no
 	

 
 	See [[CSS3BG]].
@@ -166,17 +147,12 @@ Corner Sizing: the 'border-radius property
 

 Corner Shaping: the 'corner-shape' property

 
-	
+	
 		Name:            corner-shape
-		Value:           [round | bevel | scoop | notch]{1,4}
+		Value:           [ round | bevel | scoop | notch ]{1,4}
 		Initial:         round
 		Applies to:      all elements, except table element when 'border-collapse' is ''collapse''
 		Inherited:       no
-		Percentages:     n/a
-		Media:           visual
-		Computed value:  specified value
-		Animatable:      no
-		Canonical order: n/a
 	

 
 	By default, non-zero border-radii define
@@ -219,15 +195,9 @@ Corner Shaping: the 'corner-shape' property
 

 Corner Shape and Size: the 'corners' shorthand

 
-	
+	
 		Name: corners
 		Value: <<'corner-shape'>> || <<'border-radius'>>
-		Initial: see individual properties
-		Applies to: see individual properties
-		Inherited: see individual properties
-		Percentages: see individual properties
-		Media: visual
-		Computed value: see individual properties
 	

 
 	The 'corners' shorthand sets 'corner-shape' and 'border-radius' in the same declaration.
@@ -266,34 +236,15 @@ Partial borders
 

 Partial Borders: the 'border-limit' property

 
-	
-		
-			
-			
-			
-			
-			
-			
-			
-			
Name:
-			border-limit
-		
Value:
-			all | [ sides | corners ] [ <length> | <percentage> ]?
-				| [ top | right | bottom | left ] [ <length> | <percentage> ]
-		
Initial:
-			round
-		
Applies to:
-			 all elements, except table element when 'border-collapse' is
-				 ''collapse''
-		
Inherited:
-			no
-		
Percentages:
-			relative to border-box
-		
Media:
-			visual
-		
Computed value:
-			as specified
-	

+	
+  	Name: border-limit
+  	Value: all | [ sides | corners ] <>?
+  				| [ top | right | bottom | left ] <>
+  	Initial: round
+  	Applies to: all elements, except table element when 'border-collapse' is ''collapse''
+  	Inherited: no
+  	Percentages: relative to border-box
+	

 
 	
By default, the entire border is drawn. However, border rendering can be
 		limited to only part of a border. The keyword specifies which part, and
@@ -341,34 +292,16 @@ Partial Borders: the 'border-limit' property
 

 The 'border-clip' properties

 
-		
-			
-				
-				
-				
-				
-				
-				
-				
-				
Name:
-				border-clip, border-clip-top, border-clip-right, border-clip-bottom, border-clip-left
-			
Value:
-				normal | [ <length> | <percentage> | <fraction> ]+
-			
Initial:
-				normal
-			
Applies to:
-				all elements
-			
Inherited:
-				no
-			
Percentages:
-				refer to length of border-edge side
-			
Media:
-				visual
-			
Computed value:
-				''border-clip/normal'', or a list consisting of absolute lengths, or percentages as specified
-		

-
-		
Should these properties be simplified to only accept normal | [ <length> | <percentage> ] +?
+		
+  		Name: border-clip, border-clip-top, border-clip-right, border-clip-bottom, border-clip-left
+  		Value: normal | [ <> | <> ]+
+  		Initial: normal
+  		Inherited: no
+  		Percentages: refer to length of border-edge side
+  		Computed value: ''border-clip/normal'', or a list consisting of absolute lengths, or percentages as specified
+		

+
+		
Should these properties be simplified to only accept normal | <>+?
 
 		
These properties split their respective borders into parts along
 		the border edge. The first part is visible, the second is invisible,