[css-highlight-api] Rename HighlightRangeGroup to just Highlight

Since it's responsibilities have increased to being more than just a
group, a more generic name makes sense.

Part of w3c#4590

Author: frivoal

css-highlight-api-1/Overview.bs

@@ -83,9 +83,9 @@ Introduction</h2>
 	<div id=intro-ex class=example>
 		The following code uses the ''::highlight()'' pseudo-element
 		to apply a yellow background and blue foreground color to the text <q>One two</q>.
-		It does so by adding a {{HighlightRangeGroup}} to the {{HighlightsRegister}}
+		It does so by adding a {{Highlight}} to the {{HighlightsRegister}}
 		(both of these are new concepts introduced by this specification).
-		The {{HighlightRangeGroup}} will contain a {{Range}} whose boundary points surround the text <q>One two</q>.
+		The {{Highlight}} will contain a {{Range}} whose boundary points surround the text <q>One two</q>.
 
 		<xmp highlight=html>
 			<style>
@@ -100,7 +100,7 @@ Introduction</h2>
 			r.setStart(document.body, 0);
 			r.setEnd(document.body, 2);
 
-			CSS.highlights.add(new HighlightRangeGroup("example-highlight", [r]));
+			CSS.highlights.add(new Highlight("example-highlight", [r]));
 			</script>
 		</xmp>
 
@@ -146,7 +146,7 @@ Creating Custom Highlights</h3>
 	(see [[#events]]).
 
 	[=Custom highlights=] are represented by
-	<dfn interface>HighlightRangeGroup</dfn> objects,
+	<dfn interface>Highlight</dfn> objects,
 	[=setlike=] objects whose [=set entries=] are {{AbstractRange}} objects.
 	[=Ranges=] can be added to a [=custom highlight=]
 	either by passing a [=sequence=] of them to its constructor,
@@ -158,12 +158,12 @@ Creating Custom Highlights</h3>
 	See [[#range-invalidation]] for more details about this choice and its implications.
 
 	The <dfn for="custom highlight">name</dfn> of a [=custom highlight=]
-	is represented by its {{HighlightRangeGroup/name}} attribute,
+	is represented by its {{Highlight/name}} attribute,
 	which must must be a valid <<ident-token>>.
 
 	<xmp class="idl">
 	[Exposed=Window]
-	interface HighlightRangeGroup {
+	interface Highlight {
 		constructor(CSSOMString name, optional sequence<AbstractRange> initialRanges = []);
 		setlike<AbstractRange>;
 		attribute CSSStyleDeclaration style;
@@ -172,26 +172,26 @@ Creating Custom Highlights</h3>
 	};
 	</xmp>
 
-	See [[#priorities]] for more information on the {{HighlightRangeGroup/priority}} attribute,
-	and [[#style-attr]] for more information on the {{HighlightRangeGroup/style}} attribute.
+	See [[#priorities]] for more information on the {{Highlight/priority}} attribute,
+	and [[#style-attr]] for more information on the {{Highlight/style}} attribute.
 
 	<div algorithm="to create a custom highlight">
-		When the <dfn for=HighlightRangeGroup constructor>HighlightRangeGroup(CSSOMString name, optional sequence<AbstractRange> initialRanges = [])</dfn> constructor is invoked,
+		When the <dfn for=Highlight constructor>Highlight(CSSOMString name, optional sequence<AbstractRange> initialRanges = [])</dfn> constructor is invoked,
 		run the following steps:
 
 		<ol>
 			<li>
-				Let |highlightRangeGroup| be the new {{HighlightRangeGroup}} object.
+				Let |highlight| be the new {{Highlight}} object.
 			<li>
 				If {{name!!argument}} does not [=CSS/parse=] as an <<ident-token>>, then [=throw=] a {{"SyntaxError"}}. 
 			<li>
 				Let |nameArg| be the result of [=converted to an ECMAScript value|converting=] {{name!!argument}} to an ECMAScript value.
 			<li>
-				Set |highlightRangeGroup|'s {{HighlightRangeGroup/name}} to |nameArg|
+				Set |highlight|'s {{Highlight/name}} to |nameArg|
 			<li>
-				Set |highlightRangeGroup|'s {{HighlightRangeGroup/priority}} to <code>0</code>.
+				Set |highlight|'s {{Highlight/priority}} to <code>0</code>.
 			<li>
-				Set |highlightRangeGroup|'s {{HighlightRangeGroup/style}}
+				Set |highlight|'s {{Highlight/style}}
 				to a [=CSS declaration block=] object
 				whose [=readonly flag=] is unset,
 				whose [=parent CSS rule=] is <code>null</code>,
@@ -201,10 +201,10 @@ Creating Custom Highlights</h3>
 				For each |range| of {{initialRanges}},
 				let |rangeArg| be the result of [=converted to an ECMAScript value|converting=] |range| to an ECMAScript value,
 				then run [[webidl#es-add-delete|the steps for a built-in setlike add function]],
-				with |highlightRangeGroup| as the <code>this</code> value,
+				with |highlight| as the <code>this</code> value,
 				and |rangeArg| as the argument.
 			<li>
-				Return |highlightRangeGroup|.
+				Return |highlight|.
 		</ol>
 	</div>
 
@@ -231,8 +231,8 @@ Registering Custom Highlights</h3>
 
 	[Exposed=Window]
 	interface HighlightsRegister {
-		setlike<HighlightRangeGroup>;
-		HighlightsRegister add(HighlightRangeGroup value);
+		setlike<Highlight>;
+		HighlightsRegister add(Highlight value);
 	};
 	</xmp>
 
@@ -242,9 +242,9 @@ Registering Custom Highlights</h3>
 		with the [=custom highlight=] as the argument.
 
 		When invoked,
-		the <dfn method for=HighlightsRegister>add(HighlightRangeGroup value)</dfn> method must run these steps:
+		the <dfn method for=HighlightsRegister>add(Highlight value)</dfn> method must run these steps:
 
-		1. If there is already a [=set entry=] with the same {{HighlightRangeGroup/name}} as the {{HighlightRangeGroup/name}} of {{value}},
+		1. If there is already a [=set entry=] with the same {{Highlight/name}} as the {{Highlight/name}} of {{value}},
 			then [=throw=] an {{"OperationError"}}.
 		3. Let |valueArg| be the result of [=converted to an ECMAScript value|converting=] {{value}} to an ECMAScript value.
 		4. Let |result| be the result of running [[webidl#es-add-delete|the steps for a built-in setlike add function]],
@@ -272,7 +272,7 @@ The Custom Highlight Pseudo-element: ''::highlight()''</h3>
 <h3 id=style-attr>
 Default Styling of a Custom Highlight</h3>
 
-	A [=custom highlight=]'s {{HighlightRangeGroup/style}} attribute
+	A [=custom highlight=]'s {{Highlight/style}} attribute
 	is a [=CSS declaration block=] object
 	which authors can use to define
 	the [=custom highlight=]'s <dfn>default style</dfn>.
@@ -292,15 +292,15 @@ Default Styling of a Custom Highlight</h3>
 		<xmp highlight=html>
 			<body><span>One </span><span>two </span><span>three...</span>
 			<script>
-				let highlightsRange = new Range();
-				highlightsRange.setStart(document.body, 0);
-				highlightsRange.setEnd(document.body, 2);
+				let r = new Range();
+				r.setStart(document.body, 0);
+				r.setEnd(document.body, 2);
 
-				let highlightRangeGroup = new HighlightRangeGroup("inline-highlight", [highlightsRange]);
-				highlightRangeGroup.style.backgroundColor = "yellow";
-				highlightRangeGroup.style.color = "blue";
+				let h = new Highlight("inline-highlight", [r]);
+				h.style.backgroundColor = "yellow";
+				h.style.color = "blue";
 
-				CSS.highlights.add(highlightRangeGroup);
+				CSS.highlights.add(h);
 			</script>
 		</xmp>
 
@@ -325,7 +325,7 @@ Applicable Properties</h4>
 	like the built-in [=highlight pseudo-elements=],
 	can only be styled with a limited set of properties.
 	See [[css-pseudo-4#highlight-styling]] for the full list.
-	The same limitation applies to the {{HighlightRangeGroup/style}} attribute of [=custom highlights=].
+	The same limitation applies to the {{Highlight/style}} attribute of [=custom highlights=].
 
 <h4 id=c-and-h>
 Cascading and Inheritance</h4>
@@ -338,7 +338,7 @@ Cascading and Inheritance</h4>
 	the User Agent is expected to use the OS-default highlight colors for ''::selection''
 	when neither 'color' nor 'background-color' have been specified,
 	the User Agent must use the styles provided in 
-	the {{HighlightRangeGroup/style}} attribute of the corresponding [=custom highlight=]
+	the {{Highlight/style}} attribute of the corresponding [=custom highlight=]
 	when no applicable property has been specified via ''::highlight()''.
 
 <h4 id=painting>
@@ -376,7 +376,7 @@ Painting</h4>
 						r2.setStart(document.body, 3);
 						r2.setEnd(document.body, 7);
 
-						CSS.highlights.add(new HighlightRangeGroup("sample", [r1, r2]));
+						CSS.highlights.add(new Highlight("sample", [r1, r2]));
 					</script>
 				</xmp>
 
@@ -406,7 +406,7 @@ Painting</h4>
 <h4 id=priorities>
 Priority of Overlapping Highlights</h4>
 
-	A [=custom highlight=]'s {{HighlightRangeGroup/priority}} attribute
+	A [=custom highlight=]'s {{Highlight/priority}} attribute
 	defines its <dfn>priority</dfn>.
 	This is used to determine the stacking order of the corresponding [=highlight overlay=]
 	during painting operations (see [[#painting]]).
@@ -436,7 +436,7 @@ Priority of Overlapping Highlights</h4>
 	so that they too can be reordered,
 	and so that they can be interleaved with custom ones freely?
 
-	<div class=example id=overlap-group-ex>
+	<div class=example id=overlap-highlight-ex>
 		<xmp highlight=html>
 			<style>
 				p::highlight(foo) {
@@ -457,8 +457,8 @@ Priority of Overlapping Highlights</h4>
 				r2.setStart(document.body, 3);
 				r2.setEnd(document.body, 9);
 
-				CSS.highlights.add(new HighlightRangeGroup("foo", [r1]));
-				CSS.highlights.add(new HighlightRangeGroup("bar", [r2]));
+				CSS.highlights.add(new Highlight("foo", [r1]));
+				CSS.highlights.add(new Highlight("bar", [r2]));
 			</script>
 		</xmp>
 
@@ -498,8 +498,8 @@ Repaints</h3>
 
 	The User Agent must also repaint highlights as needed
 	in response to changes by the author
-	to the {{HighlightRangeGroup/priority}},
-	to the {{HighlightRangeGroup/style}},
+	to the {{Highlight/priority}},
+	to the {{Highlight/style}},
 	or to the [=boundary points=] of {{Range}}s
 	of a [=registered=] [=custom highlight=].
 

css-ui-4/Overview.bs

@@ -24,7 +24,8 @@ Previous Version: https://www.w3.org/TR/2015/WD-css-ui-4-20150922/
 Shortname: css-ui
 Level: 4
 Group: csswg
-Status: ED
+Status: WD
+Date: 2019-12-18
 Work Status: Revising
 Editor: Florian Rivoal, On behalf of Bloomberg, https://florian.rivoal.net/, w3cid 43241
 Abstract: This specification describes user interface related