TelamonScreenshotCarousel

A row of screenshots shown one at a time with previous and next buttons, dots and arrow keys, loading only the neighbours.

Since 1.3.0

A row of screenshots, one at a time: previous and next buttons over the picture, dots below (a "3 / 20" counter instead when there are more than 12; nothing for a single screenshot), and the arrow keys. Only the shown image and its two neighbours are loaded, asynchronously and at a bounded size. At most the first 50 sources are shown. With no sources it shows a short "No screenshots" message. Use it on an app's detail page, next to TelamonInstallButton.

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

Example

TelamonScreenshotCarousel {
    sources: [Qt.resolvedUrl("shots/a.png"), "qrc:/b.png"]
    Layout.fillWidth: true
    Layout.preferredHeight: width * 9 / 16
}

Properties

Name	Type	Default	Description
`allowRemote`	`bool`	`false`	Lets `https:` sources load, for a trusted source. `http:` is refused either way.
`count`	`int` (read-only)	—	How many sources are shown: at most 50, and none for something that is not a list.
`currentIndex`	`int`	`0`	The screenshot shown. Kept within `count`.
`expandable`	`bool`	`false`	A click, or Enter, opens the full-window viewer (since 1.5.0).
`expanded`	`bool`	`false`	Whether the viewer is open. Set it to open or close the viewer; it stays `false` when the carousel is not `expandable` or has no images. Since 1.5.0.
`sources`	`var`	`[]`	A list of image urls (strings or `url` values).

Signals

Name	Description
`opened(int index)`	The viewer opened on the image at `index` (since 1.5.0). `expandedChanged` fires when it opens and closes.

The viewer

With expandable: true, a click on the picture or Enter opens a viewer that fills the window. It belongs to the carousel (there is no separate type) and shows the same sources under the same rules: local files only, and https: only with allowRemote.

Images are zoomed to fit. A double click toggles 1:1; at 1:1 a large image scrolls.
Left and Right (mirrored in a right-to-left layout), Home and End move between images; so do the buttons at the sides.
Esc, the close button, or a click outside the image closes it, and focus goes back to the carousel.
A screen reader hears the image's position, "2 of 5". Under reduced motion the viewer opens without its fade, and in high contrast the dimming is solid.

TelamonScreenshotCarousel {
    expandable: true
    sources: [Qt.resolvedUrl("shots/a.png"), Qt.resolvedUrl("shots/b.png")]
    onOpened: index => stats.viewed(index)
}

Keyboard

The arrow keys go to the previous and next screenshot; Home and End go to the first and last. With expandable, Enter opens the viewer.

Where pictures may come from

Each source is resolved the way Qt reads it. Only local files (file:, no host), qrc: and image: (the app's own image providers) load. Anything else (http:, ftp:, data:, a //host url, control characters) is refused: the slide shows the broken-image state, and the first refusal is logged with its scheme only.

Note

Pass absolute urls (Qt.resolvedUrl("shots/a.png") in the app's file): a relative one is read against Telamon.Ui's own files. An app that shows remote screenshots should download them itself and pass the local files, which is best. Otherwise set allowRemote: true for a trusted source. Qt logs the whole url of an image that fails to load, so a remote url must carry no secret (no token in its query). A file: source should come from the app's own download or cache, not straight from metadata.