Components/Data display

ECountdown Countdown

import EUI 1.0

Examples

Standalone countdown

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ECountdown { title: qsTr("Next update in") value: Date.now() + 600000 format: "mm:ss" }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Properties

PropertyDescriptionValues and default

countdownbool

Interpret the statistic value as a target time and show time remaining.

Defaulttrue

decimalSeparatorstring

Decimal separator for statistics.

DefaultLocalized text

enabledbool

Allow interaction; false disables the control.

Defaulttrue

formatstring

Display format: date/time pattern, progress callback or countdown time placeholders.

Default"HH:mm:ss"

formattervar

Formatting callback converting a value to displayed text.

Defaultnull

groupSeparatorstring

Thousands separator for statistics.

DefaultLocalized text

heightreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitHeight

precisionint

Number of decimal places.

Default0

prefixstring

Prefix or suffix text; Mention prefix is a trigger character or character array.

Default""

prefixDelegateComponent

Component slot for custom prefix; null uses the default content. See this page’s examples for delegate context.

Defaultnull

suffixstring

Prefix or suffix text; Mention prefix is a trigger character or character array.

Default""

suffixDelegateComponent

Component slot for custom suffix; null uses the default content. See this page’s examples for delegate context.

Defaultnull

titlestring

Title text.

Default""

titleDelegateComponent

Component slot for custom title; null uses the default content. See this page’s examples for delegate context.

Defaultnull

valuevar

Target time as a Date-compatible value or Unix timestamp in milliseconds.

Default0

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitWidth

displayValuestringRead only

Display text after formatting, progress or badge rules.

DefaultComputed at runtime

remainingrealRead only

Countdown time remaining in milliseconds.

DefaultComputed at runtime

Signals

SignaturePurpose

finished()

Emitted when the countdown reaches its end time.

changed(real remaining)

Emitted on a countdown update; remaining is the remaining time.

finish()

Emitted when the countdown finishes.