Configuring a StorytellerListView

StorytellerListViewDelegate has methods for managing StorytellerRowView and StorytellerGridView events. Please see the dedicated StorytellerDelegate for handling other events.

Note: All of the example code snippets are using the StorytellerRowView type, however, if you are using StorytellerGridView they will work in exactly the same way.

Attributes

The StorytellerRowView (see StorytellerRowView) and StorytellerGridView (see StorytellerGridView) can be customized using these attributes:

• cellType - the style of cell, it can be either round or square, default value is square
• cellSpacing - the spacing of Stories inside the row, default value is 4.0. Note that this is handled slightly differently for the list types - see StorytellerRowView or StorytellerGridView for details
• delegate - the StorytellerListViewDelegate instance for StorytellerListView callbacks (see Implementing StorytellerListViewDelegate methods)
• categories - assigns list of Story Categories to be displayed inside row.
• theme - theming style used to render Story items in list and activities launched from this list. If theme is not set by user then Storyteller.theme global attribute is used (see here for more details)
• uiStyle - sets whether it should be rendered in light or dark mode, it can be auto, light, or dark. The default value is auto.

StorytellerListViewCellType

The StorytellerListViewCellType enum can be used to set the cellType property in a StorytellerRowView or StorytellerGridView, the property can also be set as a plain string matching the values round or square

    let storytellerRow = StorytellerRowView()
    storytellerRow.cellType = StorytellerListViewCellType.round.rawValue

StorytellerListViewStyle

The uiStyle property can be used to set the overall color schemes, suitable for dark or light modes. This is optional and can be adjusted for additional UI mode control.

• StorytellerListViewStyle.auto - default value, the SDK will adjust its color scheme automatically according to the current system UI mode
• StorytellerListViewStyle.light - force the SDK to use the light theme
• StorytellerListViewStyle.dark - force the SDK to use the dark theme

Using in dynamic containers

If you are using in StorytellerRowView or StorytellerGridView remember to attach prepareForReuse to UITableViewCell lifecycle

override func prepareForReuse() {
    super.prepareForReuse()
    storytellerRow.prepareForReuse()
}

Categories

The categories property assigns list of Categories to be displayed inside the row/grid.

let storytellerRow = StorytellerRowView()
storytellerRow.categories = ["<category-id-1>", "<category-id-2>"]

Methods

dismissStoryView

dismissStoryView(animated: Bool, dismissReason: String? = nil, onComplete: (() -> Void)? = nil)

This method has been deprecated. Please use Storyteller.dismissStoryView(animated:dismissReason:onComplete) instead. See Additional Methods for more details.

reloadData

reloadData()

The reloadData method starts loading fresh data for all Stories from the API. On completion, it updates the Story data, starts prefetching content and updates the read status of the Stories. The onDataLoadStarted and onDataLoadComplete methods on the StorytellerListViewDelegate are called accordingly (the latter with appropriate data depending on the result of the API requests).

let storytellerRow = StorytellerRowView()
storytellerRow.reloadData()

openStory

openStory(id: String = "", animated: Bool = true, onError: ((StorytellerListViewError) -> ())? = nil)

The openStory method opens a specific Story by its id parameter, a UUID identifier returned from the API. If a Story with the id is not found then the row will reload itself and try to find it again. If it fails then custom onError callback is called. animated specifies whether or not a scrolling animation will be played if a Story is not currently visible inside the row. onError is called if this an error opening the requested Story - including if the Story is not currently available. The StorytellerListViewError will contain information on the error which occurred.

let storytellerRow = StorytellerRowView()

storytellerRow.openStory()            //Opens the first story
storytellerRow.openStory(id: "")      //Opens the first story
storytellerRow.openStory(id: <story-id>)  //Opens the story with id <story-id>, if that doesn't exist it then opens the first story

openPage

openPage(id: String = "", animated: Bool = true, onError: ((StorytellerListViewError) -> ())? = nil)

The openPage method opens a specific Page by its id parameter, a UUID identifier returned from the API. If a Page with the id is not found then the row will reload itself and try to find the Page again. If it fails then custom onError callback is called. animated specifies whether or not a scrolling animation will be played if a Story is not currently visible inside the row. onError is called if this an error opening the requested Page - including if the Page is not currently available. The StorytellerListViewError will contain information on the error which occurred.

let storytellerRow = StorytellerRowView()

storytellerRow.openPage()           // Error message displayed to the user
storytellerRow.openPage(id: "")     // Error message displayed to the user
storytellerRow.openPage(id: <page-id>) // Opens the page with id <page-id>

openDeeplink

openDeeplink(url: URL, onError: ((StorytellerListViewError) -> ())? = nil)

The openDeeplink method opens a specific Page and Story using id parameters extracted from URL. If a Story with the url is not found then the row will reload itself and try to find it again. If it fails then custom onError callback is called. onError is called if this an error opening the requested Page - including situation when the Page is not currently available. The StorytellerListViewError will contain information on the error which occurred.

let storytellerRow = StorytellerRowView()

storytellerRow.openDeeplink(url: URL(<deeplink-url>)!) // Opens proper story and page