org::kde::kirigami::Card Class Reference

Inheritance diagram for org::kde::kirigami::Card:

Properties
list< QtObject >	actions
alias	banner
alias	hiddenActions
Properties inherited from org::kde::kirigami::templates::AbstractCard
Item	footer
Item	header
int	headerOrientation
bool	showClickFeedback

Detailed Description

This component implements a standard layout of a card.

It is recommended to use this class when the concept of Cards is needed in the application.

This Card has default items as AbstractCard::header and AbstractCard::footer. The header is an image that can contain an optional title and icon, accessible via the ::banner grouped property.

The footer will show a series of toolbuttons (and eventual overflow menu) representing the actions list accessible with the list property actions. It is possible even tough is discouraged to override the footer: in this case the actions property shouldn't be used.

See also

KDE Human Interface Guidelines on Cards

Since

org.kde.kirigami 2.4

Definition at line 30 of file Card.qml.

Property Documentation

actions

list< kirigami::Action > org::kde::kirigami::Card::actions

read

This property holds visible actions that will be available in the footer of the card.

The actions will be represented by a list of ToolButtons with an optional overflow menu, when not all of them will fit in the available Card width.

Definition at line 41 of file Card.qml.

banner

Image org::kde::kirigami::Card::banner

read

This grouped property controls the banner image present in the header.

Remarks

This property is read-only

This grouped property has the following sub-properties:

• source: url: The source for the image. It understands any URL valid for an Image component.
• titleIcon: string: The optional icon to put in the banner, either a freedesktop-compatible icon name (recommended) or any URL supported by QtQuick.Image.
• title: string: The title for the banner, shown as contrasting text over the image.
• titleAlignment: Qt::Alignment: The alignment of the title inside the image. default: Qt.AlignTop | Qt.AlignLeft
• titleLevel: int: The Kirigami.Heading level for the title, which controls the font size. default: 1, which is the largest size.
• titleWrapMode: QtQuick.Text.wrapMode: Whether the header text should be able to wrap. default: Text.NoWrap

It also has the full set of properties that QtQuick.Image has, such as sourceSize and fillMode.

See also

kirigami::private::BannerImage

Definition at line 74 of file Card.qml.

hiddenActions

list< kirigami::Action > org::kde::kirigami::Card::hiddenActions

read

This property holds hidden actions that will be available in the footer.

These actions will only be shown in the overflow menu, even when there is enough space.

Deprecated:

Use actions with a Kirigami.DisplayHint.AlwaysHide as displayHint.

See also

kirigami::DisplayHint

Since

org.kde.kirigami 2.6

Definition at line 52 of file Card.qml.

---

The documentation for this class was generated from the following file:

• Card.qml