Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cfoulston/Unity-Reorderable-List
Extended version of the Reorderable List in Unity
https://github.com/cfoulston/Unity-Reorderable-List
list unity unity3d
Last synced: about 1 month ago
JSON representation
Extended version of the Reorderable List in Unity
- Host: GitHub
- URL: https://github.com/cfoulston/Unity-Reorderable-List
- Owner: cfoulston
- License: mit
- Created: 2017-04-11T17:23:18.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-01-06T21:28:52.000Z (almost 4 years ago)
- Last Synced: 2024-08-03T05:17:57.036Z (4 months ago)
- Topics: list, unity, unity3d
- Language: C#
- Homepage: https://forum.unity3d.com/threads/reorderable-list-v2.339717/
- Size: 282 KB
- Stars: 633
- Watchers: 31
- Forks: 96
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-unity3d - Unity-Reorderable-List - Extended version of the Reorderable List in Unity (Open Source Repositories / Editor)
- awesome-opensource-unity - Unity-Reorderable-List - Extended version of the Reorderable List in Unity. (Open Source Packages / Editor)
- AwesomeCppGameDev - Unity-Reorderable-List
- awesome-unity-open-source-on-github - Unity-Reorderable-List - Extended version of the Reorderable List (Inspector)
README
# Reorderable List
An attempt to mimic the ReorderableList within Unity while adding some extended functionality.
## Installation
This extension can be installed using Unity package manager.
`https://github.com/cfoulston/Unity-Reorderable-List.git`
* Package manager UI
* Manifest
{
"dependencies": {
"com.malee.reorderablelist": "https://github.com/cfoulston/Unity-Reorderable-List.git"
}
}
* A standalone version is available under the [standalone](https://github.com/cfoulston/Unity-Reorderable-List/tree/standalone) branch, although this version is no longer maintained.
## Features
* Drag and Drop references (like array inspector)
* Expandable items and list itself
* Multiple selection (ctrl/command, shift select)
* Draggable selection
* Context menu items (revert values, duplicate values, delete values)
* Custom attribute which allows automatic list generation for properties*
* Event delegates and custom styling
* Pagination
* Sorting (sort based on field, ascending and descending)
* Surrogates (Enable adding elements of a different type)
## Usage
There are two ways to use the ReorderableList
1. Create a custom Editor for your class and create a ReorderableList pointing to your serializedProperty
2. Create custom list class which extends from ReorderableArray, assign [Reorderable] attribute above property (not class).
## Pagination
Pagination can be enabled in two ways:
1. With the [Reorderable] attribute:
* `[Reorderable(paginate = true, pageSize = 0)]`
2. Properties of the ReorderableList:
* `list.paginate`
* `list.pageSize`
`pageSize` defines the desired elements per page. Setting `pageSize = 0` will enable the custom page size GUI
When enabled, the ReorderableList GUI will display a small section below the header to facilitate navigating the pages
#### NOTE
*Elements can be moved between pages by right-clicking and selecting "Move Array Element"*
## Surrogates
Surrogates can be created to facilitate adding Objects to a ReorderableList that don't match the ReorderableList type.
This can be achieved in two ways:
1. With the [Reorderable] attribute:
* `[Reorderable(surrogateType = typeof(ObjectType), surrogateProperty = "objectProperty")]`
2. Property of the ReorderableList:
* `list.surrogate = new ReorderableList.Surrogate(typeof(ObjectType), Callback);`
Check the `SurrogateTest` and `SurrogateTestEditor` examples for more information