Ubuntu.Components.ListItems.Empty

A list item with no contents. More...

Properties

• backgroundIndicator : list<Item>
• confirmRemoval : bool
• divider : ThinDivider
• highlightWhenPressed : bool
• removable : bool
• selected : bool
• showDivider : bool
• swipingState : string
• waitingConfirmationForRemoval : bool

Signals

• itemRemoved()

Methods

• cancelItemRemoval()

Detailed Description

Note: The component is deprecated. Use ListItem component instead. The Empty class can be used for generic list items containing other components such as buttons. It is selectable and can take mouse clicks. It will attempt to detect if a thin dividing line at the bottom of the item is suitable, but this behaviour can be overridden (using showDivider). For specific types of list items, see its subclasses.

The item will still remain in memory after being removed from the list so it is up to the application to destroy it. This can be handled by the signal itemRemoved that is fired after all animation is done.

Examples:

import Ubuntu.Components 1.3
import Ubuntu.Components.ListItems 1.3 as ListItem
Item {
Model {
id: contactModel
ListElement {
name: "Bill Smith"
number: "555 3264"
}
ListElement {
name: "John Brown"
number: "555 8426"
}
}
ListView {
width: 180; height: 200
model: contactModel
delegate: ListItem.Empty {
height: units.gu(6)
removable: true
onItemRemoved: contactModel.remove(index)
Text {
text: name + " " + number
anchors.centerIn: parent
}
}
}
}

See the documentation of the derived classes of Empty for more examples.

Property Documentation

Defines the item background item to be showed during the item swiping

Defines if the item needs confirmation before removing by swiping.

Exposes our the bottom line divider.

Highlight the list item when it is pressed. This is used to disable the highlighting of the full list item when custom highlighting needs to be implemented (for example in ListItem.Standard which can have a split).

Defines if this item can be removed or not.

Specifies whether the list item is selected.

Set to show or hide the thin bottom divider line (drawn by the ThinDivider component). This line is shown by default except in cases where this item is the delegate of a ListView.

The current swiping state ("SwipingRight" or "")

Defines if the item is waiting for the user interaction during the swipe to delete

Signal Documentation

This handler is called when the item is removed from the list

Method Documentation

Cancel item romoval