Binding Values

The BindingSystem provides a custom-built searchable dropdown menu that simplifies the access and setup of each binding property. This drawer makes it easy to configure bindings within the Inspector. Additionally, the BindingSystem is compatible with the Odin Inspector, a popular Unity extension.

Here is the detailed anatomy view of a Bind<T> drawer:

Minimal UI

Bind Inspector View

where:

1. Bind Toggle: whether the field/property is bound or uses direct value.

2. Bind Mode: this is the direction this bind is working. Can be read-only, write-only or both read and write. When holding CTRL (or CMD in MacOS) and clicking, it will toggle Live Debug

3. Field Toggles: these toggles hide or show secondary fields.

4. Bind Path: the path to bind. Uses a different format than the raw path.

5. Type: the type of the field/property to bind.

6. Bind Menu: reveals the menu specific to the field/property. Here new modifiers can be added and other options, such as Live Debug, can be enabled.

7. Source: the object source to get the values from.

8. Converter: when a converter is used, the line will appear. If the icon is gray, this means the conversion is safe, otherwise if orange, the conversion may fail, because the types are not fully compatible.

9. Modifiers: the list of modifiers. Note: the order is very important. Each modifier can be dragged to change their order.

   • A. Modifier Mode: when this modifier is used, during read operation, during write or during both. If a modifier doesn't show its modify mode button, then this modifier does not allow to change its mode.

   • B. Delete: removes the modifier from the list.

Verbose UI

Bind Inspector View

where:

1. Bind Toggle: whether the field/property is bound or uses direct value.

2. Bind Menu: reveals the menu specific to the field/property. Here new modifiers can be added and LiveDebug enabled for example.

3. Source: the object source to get the values from.

4. Type: the type of the field/property to bind.

5. Mode: this is the direction this bind is working. Can be read-only, write-only or both read and write.

6. Path: the path to bind. Uses a different format than the raw path.

7. Converter: when a converter is used, the line will appear. If the icon is gray, this means the conversion is safe, otherwise if orange, the conversion may fail, because the types are not fully compatible.

8. Converter Type: what type of converter is being used.

9. Modifiers: the list of modifiers. Note: the order is very important. Note: incompatible modifiers may not be shown.

   • A. Modifier Mode: when this modifier is used, during read operation, during write or during both.

   • B. Move Up: moves this modifier up in the list.

   • C. Move Down: moves this modifier down the list.

   • D. Delete: removes the modifier from the list.

10. Value Field: the field of the value when the field/property is not bound.

11. Path Value Preview: when enabled, shows a preview of data at selected path.

Smart Dropdown

When clicking on path control or any other Bind option button, a custom dropdown, Smart Dropdown, will appear with relevant information or options to choose from. It can handle different types of data controls, such as checkboxes, input fields, buttons, groups, and more.

When selecting a bind path, the custom dropdown lets you select direct entries:

Direct Values

Or compound entries when both the direct entry and its children are valid choices:

Compound Values

Or search a value among the ones present:

Search Values