SelectionTracker.Builder

public final class SelectionTracker.Builder

Builder is the primary mechanism for create a SelectionTracker that can be used with your RecyclerView. Once installed, users will be able to create and manipulate selection using a variety of intuitive techniques like tap, gesture, and mouse lasso.

Example usage:

SelectionTrackertracker = new SelectionTracker.Builder<>(
       "my-uri-selection",
       recyclerView,
       new DemoStableIdProvider(recyclerView.getAdapter()),
       new MyDetailsLookup(recyclerView),
       StorageStrategy.createParcelableStorage(Uri.class))
       .build();

Restricting which items can be selected and limiting selection size

SelectionPredicate provides a mechanism to restrict which Items can be selected, to limit the number of items that can be selected, as well as allowing the selection code to be placed into "single select" mode, which as the name indicates, constrains the selection size to a single item.

Configuring the tracker for single single selection support can be done by supplying createSelectSingleAnything. SelectionTrackertracker = new SelectionTracker.Builder<>( "my-string-selection", recyclerView, new DemoStableIdProvider(recyclerView.getAdapter()), new MyDetailsLookup(recyclerView), StorageStrategy.createStringStorage()) .withSelectionPredicate(SelectionPredicates#createSelectSingleAnything()) .build();

Retaining state across Android lifecycle events

Support for storage/persistence of selection must be configured and invoked manually owing to its reliance on Activity lifecycle events. Failure to include support for selection storage will result in the active selection being lost when the Activity receives a configuration change (e.g. rotation) or when the application process is destroyed by the OS to reclaim resources.

Key Type

Developers must decide on the key type used to identify selected items. Support is provided for three types: Parcelable, String, and Long.

Parcelable: Any Parcelable type can be used as the selection key. This is especially useful in conjunction with android.net.Uri as the Android URI implementation is both parcelable and makes for a natural stable selection key for values represented by the Android Content Provider framework. If items in your view are associated with stable content:// uris, you should use Uri for your key type.

String: Use String when a string based stable identifier is available.

Long: Use Long when RecyclerView's long stable ids are already in use. It comes with some limitations, however, as access to stable ids at runtime is limited. Band selection support is not available when using the default long key storage implementation. See StableIdKeyProvider for details.

Usage:

     private SelectionTrackermTracker; 
     
     public void onCreate(Bundle savedInstanceState) { 
     // See above for details on constructing a SelectionTracker instance. 
     
     if (savedInstanceState != null) { 
     mTracker.onRestoreInstanceState(savedInstanceState); 
      } 
      } 
     
     protected void onSaveInstanceState(Bundle outState) { 
     super.onSaveInstanceState(outState); 
     mTracker.onSaveInstanceState(outState); 
      }

Summary

public Builder(
    @NonNull String selectionId,
    @NonNull RecyclerView recyclerView,
    @NonNull ItemKeyProvider keyProvider,
    @NonNull ItemDetailsLookup detailsLookup,
    @NonNull StorageStrategy storage
)

public @NonNull SelectionTracker build()

public @NonNull SelectionTracker.Builder withBandOverlay(@DrawableRes int bandOverlayId)

public @NonNull SelectionTracker.Builder withBandPredicate(@NonNull BandPredicate bandPredicate)

public @NonNull SelectionTracker.Builder withFocusDelegate(@NonNull FocusDelegate delegate)

public @NonNull SelectionTracker.Builder withGestureTooltypes(@NonNull int[] toolTypes)

public @NonNull SelectionTracker.Builder withOnContextClickListener(@NonNull OnContextClickListener listener)

public @NonNull SelectionTracker.Builder withOnDragInitiatedListener(@NonNull OnDragInitiatedListener listener)

public @NonNull SelectionTracker.Builder withOnItemActivatedListener(
    @NonNull OnItemActivatedListener listener
)

public @NonNull SelectionTracker.Builder withOperationMonitor(@NonNull OperationMonitor monitor)

public @NonNull SelectionTracker.Builder withPointerTooltypes(@NonNull int[] toolTypes)

public @NonNull SelectionTracker.Builder withSelectionPredicate(
    @NonNull SelectionTracker.SelectionPredicate predicate
)