Standard
The standard list item class. It shows a basic list item with a label (text), and optionally an icon, a progression arrow, and it can have an embedded Item (control) that can be used for including Buttons, Switches etc. inside the list item. More...
Import Statement: | import Ubuntu.Components.ListItems 1.0 |
Inherits: |
Properties
- control : Item (preliminary)
- fallbackIconName : string
- fallbackIconSource : url (preliminary)
- iconFrame : bool (preliminary)
- progression : bool (preliminary)
Detailed Description
See also the Design Guidelines on List Items.
Examples:
import Ubuntu.Components 1.1 import Ubuntu.Components.ListItems 1.0 as ListItem Column { ListItem.Standard { text: "Selectable standard list item" selected: false onClicked: selected = !selected } ListItem.Standard { text: "List item with icon" iconName: "compose" } ListItem.Standard { text: "With a progression arrow" progression: true } ListItem.Standard { text: "Control" control: Button { text: "Click me" width: units.gu(19) onClicked: print("Clicked") } progression: true } }
This component is under heavy development.
Property Documentation
control : Item |
This QML property is under development and is subject to change.
An optional control that is displayed inside the list item. The width of the control must be specified in order to determine the layout of the list item.
fallbackIconName : string |
The icon shown in the list item if iconName failed to load (optional).
If both fallbackIconSource and fallbackIconName are defined, fallbackIconName will be ignored.
Note: The complete list of icons available in Ubuntu is not published yet. For now please refer to the folders where the icon themes are installed:
- Ubuntu Touch: /usr/share/icons/suru
- Ubuntu Desktop: /usr/share/icons/ubuntu-mono-dark
These 2 separate icon themes will be merged soon.
fallbackIconSource : url |
This QML property is under development and is subject to change.
The location of the icon to show in the list item if iconSource failed to load (optional).
iconFrame : bool |
This QML property is under development and is subject to change.
Show or hide the frame around the icon
progression : bool |
This QML property is under development and is subject to change.
Show or hide the progression symbol.