Instructions

USAGE INSTRUCTIONS

ScrollrectItemsAdapter8, BaseParams and BaseItemViewsHolder are the 3 core classes in our small library

dedicated to both optimize a Scroll View and programmatically manage its contents.

You can use it both for a horizontal and vertical ScrollView.

ScrollrectItemsAdapter8 it’s an abstract class, because you need to provide the height or width

(depending if it’s a vertical or horizontal ScrollRect) of each item (via your implementation of

ScrollrectItemsAdapter8.GetItem[Height/Width](int index) callback) and to populate the views with

data for each item (via your implementation of

ScrollrectItemsAdapter8.InitOrUpdateItemViewHolder(BaseItemViewsHolder viewsHolder) callback).

It's recommended to manually go through example code provided in ScrollRectItemsAdapterExample.cs

(Follow these steps while constantly looking at how it’s done in the example code in SimpleTutorial.cs

and optionally in ScrollRectItemsAdapterExample.cs)

Here’s the normal flow you’ll follow after you’ve created a Scroll View using GameObject->UI->Scroll

View:

1. create your own implementation of BaseItemViewsHolder, let's name it MyItemViewsHolder

2. create your own implementation of BaseParams (if needed), let's name it MyParams

3. create your own implementation of ScrollRectItemsAdapter8<MyParams, MyItemViewsHolder>, let's

name it MyScrollRectItemsAdapter

4. instantiate MyScrollRectItemsAdapter

5. call MyScrollRectItemsAdapter.ChangeItemCountTo(int count) once (and any time your dataset is

it'll be re-used when it goes off-viewport

- newOrRecycledViewsHolder.root will be null, so you need to instantiate your prefab (or whatever),

assign it and call newOrRecycledViewsHolder.CollectViews(). Alternatively, you can call its

AbstractViewHolder.Init(..) method, which can do a lot of things for you, mainly instantiate the prefab

and (if you want) call CollectViews()

- after creation, only MyScrollRectItemsAdapter.UpdateItemViewHolder() will be called for it when its

represented item changes and becomes visible

- this method is also called when the viewport's size grows, thus needing more items to be visible at once

5.3. MyScrollRectItemsAdapter.UpdateViewsHolder(MyItemViewsHolder) will be called when an item is

to be displayed or simply needs updating:

- use newOrRecycledViewsHolder.itemIndex to get the item index, so you can retrieve its associated

model from your data set (most common practice is to store the data list in your Params implementation)

- newOrRecycledViewsHolder.root is not null here (given the view holder was properly created in

CreateViewsHolder(..)). It's assigned a valid object whose UI elements only need their values changed

(common practice is to implement helper methods in the view holder that take the model and update

5. call MyScrollRectItemsAdapter.Dispose() when you’re done using it (usually, in the ScrollRect’s

demonstrate the feature-set and show you the basic code-flow when implementing the adapter,

following the recommended best-practices & conventions.

performance with Open GL 3 and/or Auto Graphics API. If you experience oddly low FPS, untick Auto

Graphics API and use Open GL 2 instead.

- In the ContentSizeFitter example scene: the prefab's Text will be oddly truncated if its "Vertical

Overflow" property is set to "Truncate". So a as general rule, set it to "Overflow" when you have similar

scenarios. Likewise, if you have a horizontal ScrollView, the "Horizontal Overflow" property is the one to

be modified.