openArticles

abstract fun openArticles(activity: Activity, articleIds: List<ArticleId>, index: Int = 0)

Opens a list of articles at index, letting the reader swipe from one to the next without coming back out.

Takes identifiers rather than resolved articles, so it can be called straight from a tap: it returns immediately and the reader resolves them behind its own loading state. They are fetched in parallel and served from the content cache, so re-opening the same list costs nothing.

The whole list has to resolve before the reader opens. It addresses articles by position, so a partial list would land on a different article than the one that was tapped; one that cannot be resolved surfaces as the reader's own articles-loading error.

Parameters

activity

the Activity to launch the reader from.

articleIds

the articles to page through, in the order they should be paged through.

index

which of articleIds to open on. Clamped to the list.