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

# segmentBar

Displays a list of segment bar items.

## Overview

The `segmentBar` element contains a list of `segmentBarItem` elements that are displayed
horizontally. Use the remote to move the cursor between the contained `segmentBarItem`
elements. Here’s an example that has a title and subtitle above a segment bar that
contains one item.

```xml
<segmentBarHeader>
   <title>Title</title>
   <subtitle>Subtitle</subtitle>
   <segmentBar>
      <segmentBarItem>
         <title>Title</title>
      </segmentBarItem>
   </segmentBar>
</segmentBarHeader>
```

### Subelements of segmentBar

- [segmentBarItem](/documentation/TVML/segmentbaritem)

### Elements that Use segmentBar

- [segmentBarHeader](/documentation/TVML/segmentbarheader)

## Topics

### Valid TVML Styles

[color](/documentation/TVML/color)

Changes the color of an element.

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

[tv-highlight-color](/documentation/TVML/tv-highlight-color)

Changes an element’s color when it comes into focus.

### Valid TVML Attributes

[autoHighlight](/documentation/TVML/autohighlight)

Specifies that the element should initially be in focus.

[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)