<!--
{
  "documentType" : "article",
  "framework" : "TVML",
  "identifier" : "/documentation/TVML/tv-text-highlight-style",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "tv-text-highlight-style"
}
-->

# tv-text-highlight-style

Specifies how an element looks when it comes into focus.

## Overview

Use the `tv-text-highlight-style` style to specify how a label reacts when it comes
into focus.

### Values for tv-text-highlight-style

- `marquee-and-show-on-highlight`: The `text` element associated with the `lockup`
  element is only shown when the item is in focus. The text will scroll across the
  screen if the text is longer than the available space.
- `marquee-on-highlight`: The `text` element associated with the `lockup` element
  only shows the text that fits within the width of the element. Text longer than the
  available space is truncated. When the element is in focus, text longer than the
  available space is shown through scrolling.
- `show-on-highlight`: The `text` element associated with the `lockup` element
  is only shown when the item is in focus. Text longer than the available space is
  truncated.

### Elements that Use tv-text-highlight-style

- [subtitle](/documentation/TVML/subtitle)
- [text](/documentation/TVML/text)
- [title](/documentation/TVML/title)

> Note: `tv-text-highlight-style` is only applied to the above elements when they
> are contained in a `listItemLockup` or `lockup` element. Elements contained in a
> `listItemLockup` can only use the `marquee-on-highlight`.

---

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)