<!--
{
  "documentType" : "article",
  "framework" : "TVML",
  "identifier" : "/documentation/TVML/tumblerbar",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "tumblerBar"
}
-->

# tumblerBar

Displays a list of `tumblerItem` elements.

## Overview

The `tumblerBar` element contains a list of `tumblerItem` elements that are displayed
horizontally. Use the remote to move between the contained `tumblerItem` elements.
Here’s an example of a tumbler bar containing two tumbler items.

```xml
<tumblerBar>
    <tumblerItem>
        <title>Title 1</title>
        <subtitle>5 Items</subtitle>
    </tumblerItem>
    <tumblerItem>
        <title>Title 2</title>
        <subtitle>12 Items</subtitle>
    </tumblerItem>
</tumblerBar>
```

### Subelements of tumblerBar

- [tumblerItem](/documentation/TVML/tumbleritem)

### Elements that Use tumblerBar

- [list](/documentation/TVML/list)

## Topics

### Valid TVML Styles

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

### Valid TVML Attributes

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

[theme](/documentation/TVML/theme)

Sets the color scheme for an element.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)