@@ -1012,21 +1012,19 @@ resolution until runtime, at which point it is resolved each time it is
1012
1012
encountered while evaluating an instance.
1013
1013
1014
1014
Together with ` $dynamicAnchor ` , ` $dynamicRef ` implements a cooperative extension
1015
- mechanism that is primarily useful with recursive schemas (schemas that
1016
- reference themselves). The extension point is defined with ` $dynamicAnchor ` and
1017
- only exhibits runtime dynamic behavior when referenced with ` $dynamicRef ` .
1015
+ mechanism that is primarily useful to extend recursive schemas. The extension
1016
+ point is defined with ` $dynamicAnchor ` and only exhibits runtime dynamic
1017
+ behavior when referenced with ` $dynamicRef ` .
1018
1018
1019
- The value of the ` $dynamicRef ` property MUST be a string which is a
1020
- IRI reference that contains a valid [ plain name fragment] ( #anchors ) . Resolved
1021
- against the current IRI base, it indicates the schema resource used as the
1022
- starting point for runtime resolution. This initial resolution is safe to
1023
- perform on schema load.
1019
+ The value of the ` $dynamicRef ` property MUST be a valid
1020
+ [ plain name fragment] ( #anchors ) .
1024
1021
1025
- The schema to apply is the outermost schema resource in the [ dynamic
1026
- scope] ( #scopes ) that defines a ` $dynamicAnchor ` that matches the plain name
1027
- fragment in the initially resolved IRI.
1022
+ Resolution of ` $dynamicRef ` begins by identifying the the outermost schema
1023
+ resource in the [ dynamic scope] ( #scopes ) which defines a matching
1024
+ ` $dynamicAnchor ` . The schema to apply is the subschema of this resource which
1025
+ contains the matching ` $dynamicAnchor ` .
1028
1026
1029
- For a full example using these keyword , see {{recursive-example}}.[ ^ 6 ]
1027
+ For a full example using these keywords , see {{recursive-example}}.[ ^ 6 ]
1030
1028
1031
1029
[ ^ 6 ] : The difference between the hyper-schema meta-schema in pre-2019 drafts and
1032
1030
an this draft dramatically demonstrates the utility of these keywords.
0 commit comments