A ReorderableList is an IMGUI component that displays a scrollable list of items with built-in support for reordering, adding, and removing elements. It's commonly used in Inspectors and IMGUI-based tools to manage serialized collections from MonoBehaviours and ScriptableObjects.
For UI Toolkit: If you're building UI Toolkit interfaces, use ListView instead. See the list view guidelines for basic list functionality, or continue reading this page to understand how to make ListView equivalent to ReorderableList.
OnInspectorGUI, OnGUI) that you're not porting to UI ToolkitPropertyDrawer that still returns IMGUI
ReorderableList (IMGUI) and ListView (UI Toolkit) serve similar purposes but have different out-of-the-box capabilities.
Here's how they compare:
As seen in the configurations section, Reorderable Lists come with built-in options:
1. Display a list header/title.
2. Display list without a border (hiding the border will also remove the background and header colors)
3. Allow users to add and/or remove items from the list.
4. Alllow users to reorder items form the list.
List View (UI Toolkit) has similar configurations that come as built-in options, which makes it a great alternative for Reorderable Lists :
1. Display a list header/title (which is using a foldout).
2. Rows can use alternating row colors to ease reading and input control association.
3. Allow users to add and/or remove items from the list.
4. The list can be displayed without a border
5. Alllow users to reorder items form the list (which can be with or without handles).
Spacing details
The following UI Toolkit theme variables influence ListView appearance.
For IMGUI ReorderableList: Colors are defined by the GUISkin system using texture files rather than CSS variables. In the end, ReorderableList will use the same or very similar, colors.
Values depend on the active Editor theme (Light or Dark):
UI Toolkit
Unity - Scripting API:
ListView
