A ListView with special features tailored for a look and feel fitting the Ubuntu Touch platform. The UbuntuListView works just like a regular ListView, but it adds special features such as expanding/collapsing items (when used together with the Expandable item). It provides features like automatically positioning the expanding item when it expands and collapsing it again when the user taps outside of it. More...

Import Statement: import Ubuntu.Components 1.3


  • Obsolete members


Detailed Description


import Ubuntu.Components 1.3
import Ubuntu.Components.ListItems 1.3 as ListItem
Item {
ListModel {
id: listModel
UbuntuListView {
id: ubuntuListView
anchors { left: parent.left; right: parent.right }
height: units.gu(24)
model: listModel
delegate: ListItem.Expandable {
id: expandingItem
expandedHeight: units.gu(30)
onClicked: {
ubuntuListView.expandedIndex = index;

Property Documentation

[read-only] pullToRefresh : pullToRefresh

Attached PullToRefresh to control manual model refresh. The component is disabled by default.

import QtQuick 2.4
import Ubuntu.Components 1.3
UbuntuListView {
width: units.gu(40)
height: units.gu(71)
model: XmlListModel {
source: class="string">"http://feeds.reuters.com/reuters/topNews"
query: "/rss/channel/item"
XmlRole { name: "title"; query: "title/string()" }
// let refresh control know when the refresh gets completed
pullToRefresh {
enabled: true
refreshing: model.status === XmlListModel.Loading
onRefresh: model.reload()
delegate: ListItem {
ListItemLayout {
title.text: modelData
onClicked: {

This QML property was introduced in Ubuntu.Components 1.1.