ui/co.cafeyn.cgs.api.block/BlockPageScope/issues

issues

abstract fun issues(onEvent: (IssuesBlockEvent) -> Unit, source: IssuesBlockSource = IssuesBlockSource.all(), layout: IssuesLayout = IssuesLayout.horizontal(), title: String? = null, showHeaderAction: Boolean = false, limit: Int? = null, header: @Composable () -> Unit? = null, footer: @Composable () -> Unit? = null)

Adds a shelf of issues. Same behaviour as IssuesBlock.

Parameters

onEvent

invoked when the user interacts with this block.

source

which issues to show. The whole catalogue by default.

layout

the cell and the arrangement. IssuesLayout.grid and IssuesLayout.richList must be capped with limit: the page scrolls, not the block.

title

optional heading shown above the items.

showHeaderAction

draws the heading's "see all" arrow, reported as IssuesBlockEvent.HeaderActionClick. Requires a title.

limit

caps the block to its first limit items, never paginating — see IssuesBlock.

header

replaces the built-in heading with caller-owned content, ignoring title and showHeaderAction. Collapses with the block, which content declared through custom does not.

footer

optional caller-owned content drawn below the items, inside the block.

Throws

if layout is a grid or a vertical list without limit, if limit is not strictly positive, or if showHeaderAction is set without a title.