Item Selection
An item selection refers to one or more enabled list items of a specific Data Type.
By default, all visible list items are treated as enabled.
By default, all 5 visible items are enabled. There are a total of 11 items, but 6 of them are filtered out by cropped-out filters, automatically making them disabled.
Item Selection is significant in the following ways:
- It is a target for filters and operations to work on.
- In Custom Scope mode, Child Data Type lists source data only from enabled parent items.
Grouped Items
Some Data Type lists will display items in groups. Items are grouped if they share the same name.
For example, all created mesh objects by default have a UV Map called UVMap. If we select a UV Map Data Type, and we have more than one mesh object, the UV Map list will group its items that share the same name. After the name follows a separator character <, followed by a Parent Data Type name.
Grouped items can be expanded and collapsed by toggling the small triangle icon next to their name.
UV Map data type items exhibit grouping.
Item Names
Item names generally follow a similar structure and may consist of one or more parts, depending on the Data Type. They are separated by a separator <.
- Data Name — name of the Blender data.
- Parent Data Name — name of the Parent Blender data.
- Position Index — some Data Types, e.g., Asset Tag, will have a position number between square brackets
[0]in front of the Data Name. This indicates their position on the parent data.
Some Data Types may have additional entries. E.g., NLA Strip items follow the following format:
NLA Strip Name < NLA Track Name < NLA TRACK OWNER's NAME
Multiselect Mode
In multiselect mode, you can individually include (enable) or exclude (disable) a list item from the selection.
With multiselect mode enabled, only 3 of 5 visible items are enabled. There are a total of 11 items, but 6 of them are filtered out by cropped-out filters, automatically making them disabled.
- The enabled/disabled status is set to "enabled" by default for every new list item.
- The enabled/disabled status is not saved with Blender. Upon reloading the file, all list items will be enabled again.
- The enabled/disabled status is not affected by Blender's undo/redo system.
- The enabled/disabled status of list items are cached by item name for use convenience. As a result, if you disable an item named "Cube", delete it in Blender, then create a new object and name it "Cube", it's value is going to be set to "disabled".