Class: GridPresenterBase

new GridPresenterBase() → {GridPresenterBase}

Constructor - view is set later via onInit()

Properties

Name	Type	Description
`view`	dynamic	Reference to the BaseGridView component
`log`	dynamic	Reference to the log instance
`apiFilters`	dynamic	Cached filter options from API (invalid = not loaded, {} = load failed)

Source: source/GridView/GridPresenterBase.bs, line 10

Returns:

Type:: GridPresenterBase

Methods

clearPresentationInfo() → {void}

Clears/hides the presentation info display

Source: source/GridView/GridPresenterBase.bs, line 127

Returns:

Type:: void

configureLoadTask(task, parentItem, viewMode, _task, _parentItem, _viewMode) → {void}

Configures the LoadItemsTask2 for data loading

Parameters:

Name	Type	Description
`task`	object	The LoadItemsTask2 node
`parentItem`	object	The library item being displayed
`viewMode`	string	Current view mode (e.g., "Movies", "MoviesGrid")
`_task`	object
`_parentItem`	object
`_viewMode`	string

Source: source/GridView/GridPresenterBase.bs, line 67

Returns:

Type:: void

createInfoNodes(infoGroup, _infoGroup) → {void}

Creates presenter-specific info nodes in the presentationInfo group Called during onInit() if presenter needs custom info display

Parameters:

Name	Type	Description
`infoGroup`	object	The presentationInfo Group node
`_infoGroup`	object

Source: source/GridView/GridPresenterBase.bs, line 120

Returns:

Type:: void

getBackdropMode() → {string}

Returns the backdrop mode for this presenter

Source: source/GridView/GridPresenterBase.bs, line 25

Returns:

"presentation" | "fullscreen" | "none"

Type:: string

getGridConfig(viewMode, _viewMode) → {object}

Returns grid layout configuration for the specified view mode

Parameters:

Name Type Description

Name	Type	Description
`viewMode`	string	Current view mode translation: [x, y] grid position itemSize: [width, height] size of each grid cell rowHeights: [height] array of row heights numRows: string number of visible rows numColumns: string number of columns imageDisplayMode: "scaleToZoom" \| "scaleToFit"
`_viewMode`	string

viewMode

string

Current view mode

translation: [x, y] grid position
itemSize: [width, height] size of each grid cell
rowHeights: [height] array of row heights
numRows: string number of visible rows
numColumns: string number of columns
imageDisplayMode: "scaleToZoom" | "scaleToFit"

_viewMode string

Source: source/GridView/GridPresenterBase.bs, line 89

Returns:

Grid config with properties:

Type:: object

getItemType() → {string}

Returns the item type(s) to load

Source: source/GridView/GridPresenterBase.bs, line 74

Returns:

Item type(s) for API query (e.g., "Movie", "Series,Movie")

Type:: string

getOptions(parentItem, _parentItem) → {object}

Returns the options configuration for ItemGridOptions

Parameters:

Name	Type	Description
`parentItem`	object	The library item being displayed
`_parentItem`	object

Source: source/GridView/GridPresenterBase.bs, line 44

Returns:

Options object with views, sort, filter arrays

Type:: object

loadFilters(parentItem, itemType) → {void}

Load dynamic filter options (Genres, Years, Ratings) from the Jellyfin API. Call from configureLoadTask() in subclasses that need dynamic filters. Results arrive via onFiltersLoaded() and are cached in m.apiFilters.

Parameters:

Name	Type	Description
`parentItem`	object	The library item to load filters for
`itemType`	string	The item type to filter (e.g., "Movie", "Series")

Source: source/GridView/GridPresenterBase.bs, line 138

Returns:

Type:: void

onDestroy() → {void}

Called when presenter is being destroyed Override to clean up resources, stop tasks, unobserve fields Always call super.onDestroy() at the end of overrides

Source: source/GridView/GridPresenterBase.bs, line 166

Returns:

Type:: void

onFiltersLoaded(event) → {void}

Called when filters are loaded from API (via onPresenterFiltersLoaded bridge in BaseGridView). Caches the result in m.apiFilters and shows a toast on failure.

Parameters:

Name	Type	Description
`event`	object	roSGNodeEvent for the "filters" field change

Source: source/GridView/GridPresenterBase.bs, line 147

Returns:

Type:: void

onInit(view) → {void}

Called after presenter is attached to BaseGridView Stores view reference and creates shared task nodes Override in subclass but call super.onInit(view) first

Parameters:

Name	Type	Description
`view`	object	Reference to BaseGridView component

Source: source/GridView/GridPresenterBase.bs, line 35

Returns:

Type:: void

onItemFocused(item, currentView, _item, _currentView) → {void}

Called when an item receives focus Override to update presentation info display

Parameters:

Name	Type	Description
`item`	object	The focused ContentNode item
`currentView`	string	The current view mode (e.g., "Movies", "MoviesGrid")
`_item`	object
`_currentView`	string

Source: source/GridView/GridPresenterBase.bs, line 110

Returns:

Type:: void

onOptionsClosed(options, _options) → {void}

Called when options dialog is closed Override to handle presenter-specific option changes

Parameters:

Name	Type	Description
`options`	object	The ItemGridOptions component
`_options`	object

Source: source/GridView/GridPresenterBase.bs, line 54

Returns:

Type:: void

shouldShowPresentationInfo(viewMode, _viewMode) → {boolean}

Returns whether to show presentation info panel for the view mode

Parameters:

Name	Type	Description
`viewMode`	string	Current view mode
`_viewMode`	string

Source: source/GridView/GridPresenterBase.bs, line 98

Returns:

True to show info panel

Type:: boolean

showToast(message, toastTypeopt) → {void}

Show a toast notification via the scene-level Toast component. Safe to call from presenter classes (routes through view's scene reference).

Parameters:

Name	Type	Attributes	Default	Description
`message`	string			The message to display
`toastType`	string	<optional>	"error"	"error", "success", or "info"

Source: source/GridView/GridPresenterBase.bs, line 157

Returns:

Type:: void