A component moniker identifies a specific component instance in the component tree using a topological path of child names.
This section describes the syntax used for displaying monikers to users.
Child names
Parents assign names to each of their children. Dynamically created children are arranged by their parent into named collections.
A child name is represented by the child's static name (assigned in a
component manifest), or collection name and the runtime-assigned child name
delimited by :
.
Syntax: {name}
or {collection}:{name}
Examples:
carol
support:dan
- The collectionsupport
with the childdan
.
The {name}
and {collection}
must follow the regex [-_.a-z0-9]{1,100}
.
That is, a string of 1-100 of the following characters: a-z
, 0-9
, _
, .
,
-
.
See the component manifest reference for more details.
Monikers
Represented by the minimal sequence of child names encountered when tracing
downwards to the target delimited by a /
(slash).
Monikers do not support upward traversal (i.e. ..
) (from child to parent).
Examples:
.
- self - no traversal neededcarol
- a child - traverse downcarol
carol/sandy
- a grandchild - traverse downcarol
then downsandy
support:dan
- a child - traverse down into collection childsupport:dan