Documentation: target containers path

In some my scripts you can find short but sophisticated input field of selecting target container(s).
This is the documentation of all abilities this input.

Doc for target containers path

 
object
 
background
 
title
 
element_one
 
element_two
 
logic
 
items
 
item1
 
back
 
value
 
item2
 
back
 
value
 
item3
 
back
 
value
 
element_three
 
footer
 
back
 
text
Type your query, or hover on the elements below:

General selectors

. or this
the current container (where the script is placed)
logic
.. or ./..
get parent
object
/object
“/” defines the root of the scene tree (it works only in the beginning of the query!)
object
*
select all containers in the current sub-tree level
background
title
element_one
element_two
logic
items
element_three
footer
/**
select all containers in the tree
object
background
title
element_one
element_two
logic
items
item1
back
value
item2
back
value
item3
back
value
element_three
footer
back
text
items/*
select all direct sub-containers
item1
item2
item3

By name

title or ./title
select container by name in the current level of sub-tree
title
element_* or ./element_*
select containers by name with the wildcard "*"
element_one
element_three
/**/back
find containers by name in whole tree
back
back
back
back
items/re:^item[1|2]
find containers by Regular Expression
item1
item2

By relative index

--1 or previous or prev or up
previous container
element_two
++1 or next or down
next container
items
--2
previous of previous container
element_one
++3
next of next of next container
footer
-- or --all or --*
all previous containers in the same level
background
title
element_one
element_two
++ or ++all or ++*
all next containers in the same level
items
element_three
footer

By order index

1
the first container in the current level of sub-tree
background
-1
the last container in the current level of sub-tree
footer

Ranges

1..3
get from 1 to 3 indexes containers in the current level of sub-tree
background
title
element_one
-2..-1
get two last containers
element_three
footer
3..-1
get from the third to the last containers in the current level of sub-tree
element_one
element_two
logic
items
element_three
footer
2,4,6
get the list of containers with indexes 2, 4, 6
title
element_two
items
3..
get the list of containers with indexes 3 and more
element_one
element_two
logic
items
element_three
footer
..4
get the list of containers with indexes 4 and less (first 4 containers)
background
title
element_one
element_two