AtlasShelf

AtlasShelf is a titled row of cards that scrolls sideways ("Editors' choice", "New apps"). A button at each end scrolls by most of a screenful and hides when there is nothing more that way. Inside is a horizontal ListView, so only the visible cards exist and a model of thousands costs what a screenful does. For one column of rows, use AtlasListView.

AtlasShelf is a Qt Quick Controls Control; its inherited properties work as usual.

Example

AtlasShelf {
    title: qsTr("Editors' choice")
    model: [
        { name: "Atlas Notepad", summary: qsTr("Fast, plain text editing"), sizeText: "12 MB", rating: 4.6, verified: true },
        { name: "Atlas Monitor", summary: qsTr("Processes, memory and disks"), sizeText: "8 MB" }
    ]
    onActivated: index => openPage(index)
}

The default delegate is an AtlasAppCard. It reads name, summary, sizeText, rating, iconName, installState, progress and verified from each entry (a list of objects, or the roles of an item model) and emits activated(index) when pressed. A custom delegate gets the usual index, model and modelData, and sets its own width; cardWidth is the width the default card uses. The row is as high as the tallest card made so far (its implicit or its set height), and is measured again when the model changes; the default cards all take the row's height, so a row is even. A delegate must not size its height from the list, or the row could never shrink.

Keyboard

The cards are Tab stops, and Tab and Shift+Tab go through them in index order (each card's own stops, such as its install button, in between), then on out of the row. Left and Right move to the previous and next card (swapped in a right-to-left layout), Home and End go to the first and last. A card that takes focus is scrolled fully into view.

Right-to-left and motion

In a right-to-left layout the row, its first card and its buttons are mirrored: the start button is on the right. Under reduced motion a button press scrolls at once. In high contrast the buttons get the strong border.

Properties

Signals

Accessibility

The title is a heading and the shelf's accessible name. The two scroll buttons are named "Scroll to start" and "Scroll to end"; they take no Tab stop, since the cards scroll themselves into view.