AtlasAppCard

A store card for one app: icon, name, short summary, rating and size, with an install button at the end.

AtlasAppCard shows one app in a store. Pressing the card anywhere except on its action emits clicked: open the app's page. The action at the end is an AtlasInstallButton unless you give another through actionComponent.

AtlasAppCard is a Qt Quick Templates AbstractButton; its inherited properties (icon.name, icon.source, clicked) work as usual. See https://doc.qt.io/qt-6/qml-qtquick-controls-abstractbutton.html.

Example

AtlasAppCard {
    name: "Atlas Notepad"
    summary: qsTr("Fast, plain text editing")
    icon.name: "accessories-text-editor"      // or icon.source: a url
    rating: 4.6                                // 0 hides it
    sizeText: "12 MB"
    installState: "installing"                 // see AtlasInstallButton
    progress: 0.4
    onClicked: openPage()
    onActionClicked: install()
    onCancelRequested: cancel()
}

Another action goes in actionComponent, a Component the card sizes and centres at its end:

AtlasAppCard {
    actionComponent: Component { TextButton { text: qsTr("Manage") } }
}

Keyboard

The card is a Tab stop, and so is its action. Return or Enter on the focused card emits clicked; an action inside the card that has focus keeps its own Return.

Properties

Name	Type	Default	Description
`actionComponent`	`Component`	`defaultAction`	Replaces the AtlasInstallButton. Leave it alone to keep the default.
`defaultAction`	`Component` (read-only)	an AtlasInstallButton	The default action, bound to `installState` and `progress`.
`installState`	`string`	`"install"`	Forwarded to the default action; see AtlasInstallButton.
`name`	`string`	`""`	The app's name, also its spoken name.
`progress`	`real`	`-1`	Forwarded to the default action; see AtlasInstallButton.
`rating`	`real`	`0`	Stars, 0 to 5. A value of 0 or less shows none.
`sizeText`	`string`	`""`	The download or installed size, already formatted ("12 MB").
`summary`	`string`	`""`	A short description, up to two lines.
`symbol`	`int` (a `Symbols.<Name>` value, see Symbols)	`0`	The icon for an app without `icon.name` or `icon.source`. 0 shows `Symbols.Apps`.

Signals

Name	Description
`actionClicked()`	The default action was clicked (not while `installState` is `"installing"`).
`cancelRequested()`	The default action asked to cancel an install in progress.