diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs index 8e4bc909..d2c0e7e5 100644 --- a/css-properties-values-api/Overview.bs +++ b/css-properties-values-api/Overview.bs @@ -67,7 +67,7 @@ Registering custom properties {#registering-custom-properties} ==============================================================
-dictionary PropertyDescriptor { +dictionary PropertyDefinition { required DOMString name; DOMString syntax = "*"; required boolean inherits; @@ -75,41 +75,41 @@ dictionary PropertyDescriptor { }; partial namespace CSS { - void registerProperty(PropertyDescriptor descriptor); + void registerProperty(PropertyDefinition definition); };Additional, the {{Document}} object gains a new \[[registeredPropertySet]] private slot, which is a set of records that describe registered custom properties. -The {{PropertyDescriptor}} dictionary {#the-propertydescriptor-dictionary} +The {{PropertyDefinition}} dictionary {#the-propertydefinition-dictionary} -------------------------------------------------------------------------- -A PropertyDescriptor dictionary represents author-specified configuration -options for a custom property. {{PropertyDescriptor}} dictionaries contain the +A PropertyDefinition dictionary represents author-specified configuration +options for a custom property. {{PropertyDefinition}} dictionaries contain the following members: -: name +: name :: The name of the custom property being defined. -: syntax +: syntax :: A string representing how this custom property is parsed. -: inherits +: inherits :: True if this custom property should inherit down the DOM tree; False otherwise. -: initialValue +: initialValue :: The initial value of this custom property. The {{registerProperty()}} function {#the-registerproperty-function} -------------------------------------------------------------------- -The registerProperty(PropertyDescriptor descriptor) method +The registerProperty(PropertyDefinition definition) method registers a custom property according to the configuration options provided in -
descriptor
.
+definition
.
When it is called,
it executes the register a custom property algorithm,
-passing the options in its descriptor
argument
+passing the options in its definition
argument
as arguments of the same names.
"<transform-function>+"
Note: A syntax string of "*"
will produce the
- universal syntax descriptor, which is not a syntax component.
+ universal syntax definition, which is not a syntax component.
Therefore, "*"
may not be [[#multipliers|multiplied]] or
[[#combinator|combined]] with anything else.
@@ -529,9 +529,9 @@ The '|' combinator {#combinator}
Syntax strings may use U+007C VERTICAL LINE (|) to provide multiple
syntax component names. Such syntax strings will result in a
-syntax descriptor with multiple syntax components.
+syntax definition with multiple syntax components.
-When a syntax descriptor with multiple syntax components is used
+When a syntax definition with multiple syntax components is used
to parse a CSS value, the syntax components are matched in the order specified.
Note: That is, given the syntax string "red | <color>"
,
@@ -563,18 +563,18 @@ Parsing the syntax string {#parsing-syntax}
:: A sequence of code points which is either a data type name,
or a sequence that can produce a <