# ListDataItem

> Represents displayed item data.

- Source: https://titaniumsdk.com/docs/sdk/12.5.0/ListDataItem
- Titanium SDK version: 12.5.0
- Kind: pseudo
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0

In addition to the properties defined below, you can define custom key-value pairs, which bind to
the child templates of an [ItemTemplate](https://titaniumsdk.com/docs/sdk/ItemTemplate.md).  The key for these pairs match the `bindId` of
the child view templates and the values are a dictionary of view properties applied to the view components.
Any other properties that are not identified by a `bindId` are permitted but are ignored by the item template.

See [Titanium.UI.ListItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListItem.md) for examples of using a list data item.

## Properties

### properties

- Type: Dictionary<Titanium.UI.ListItem>
- Platforms: Android, iPhone, iPad, macOS

Contains key-value pairs of view properties and their values that are applied to the
`ListItem`.

If there are properties set in the [ItemTemplate](https://titaniumsdk.com/docs/sdk/ItemTemplate.md) (not the children view templates),
the values set in the list data item override the template's properties.

### template

- Type: String | Number
- Platforms: Android, iPhone, iPad, macOS
- Default: `If the ListView's `defaultItemTemplate` property is not set,
then <Titanium.UI.LIST_ITEM_TEMPLATE_DEFAULT> is used.
`

Template ID configured with the [Titanium.UI.ListView.templates](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListView.md#templates) property or
[Titanium.UI.LIST_ITEM_TEMPLATE_DEFAULT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LIST_ITEM_TEMPLATE_DEFAULT).

On iOS, you can specify one of the following pre-defined templates:
[Titanium.UI.LIST_ITEM_TEMPLATE_CONTACTS](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LIST_ITEM_TEMPLATE_CONTACTS),
[Titanium.UI.LIST_ITEM_TEMPLATE_SETTINGS](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LIST_ITEM_TEMPLATE_SETTINGS) or [Titanium.UI.LIST_ITEM_TEMPLATE_SUBTITLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LIST_ITEM_TEMPLATE_SUBTITLE).

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.