Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update tv_mode.md #26833

Merged
merged 3 commits into from
Dec 18, 2024
Merged

Update tv_mode.md #26833

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6df019a
Update tv_mode.md
estherk15 Dec 18, 2024
98e4ae2
Update content/en/dashboards/guide/tv_mode.md
estherk15 Dec 18, 2024
fb1d7c9
Apply suggestions from code review
estherk15 Dec 18, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/en/dashboards/guide/tv_mode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@ To ensure that your dashboard displays correctly on a TV, follow these steps:
1. **Design Your Dashboard**: Begin by creating your dashboard in Datadog. Focus on arranging your widgets within the 12-column grid layout that Datadog dashboards utilize. Keep in mind that the aspect ratio of your widgets and the overall dashboard affects how they are displayed in TV mode.
2. **Enable TV mode**: When your dashboard is ready, enable TV mode. Do this while your screen is connected to the TV and in full-screen mode. This step ensures that the dashboard automatically adjusts to fit the TV screen without the need for manual resizing.
{{< img src="/dashboards/guide/tv_mode/tv_mode_config_option.png" alt="Enable the TV mode option through the dashboard Configure menu" style="width:100%;" >}}
3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out.
3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and `CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downsides; it can make some fonts smaller and difficult to read from a distance.

## Understanding TV mode limitations

While TV mode offers a convenient way to display dashboards, there are certain limitations and considerations:
- **12-Column Grid Restriction**: Dashboards in TV mode adhere to a fixed 12-column grid. This can limit the flexibility in stretching content to fill the entire screen width. In high-density mode, the dashboard is split into two grids of 12 columns, and more widgets will expand the dashboard vertically.
- **Aspect Ratio Constraints**: TV mode resizes the dashboard to fit everything on the screen without scrolling, which means an enforced aspect ratio. If the dashboard's height and width are disproportionate, it may result in white spaces on the edges and widgets can appear minimized (zoomed out). To minimize this, design your dashboard with an aspect ratio that closely matches your TV's display.
- **Aspect Ratio Constraints**: TV mode scales down the dashboard to fit everything on the screen without scrolling, which means an enforced aspect ratio. If the dashboard's height and width are disproportionate, it may result in white spaces on the edges and widgets can appear minimized (zoomed out). To minimize this, design your dashboard with an aspect ratio that closely matches your TV's display.
- **Content Centering**: Content may be centered on the screen rather than expanding to the edges. This behavior is often due to the fixed grid system and aspect ratio. For a dashboard that fully utilizes screen width, consider switching to a screenboard, which allows finer control over widget positioning.

## Alternative solutions and recommendations
Expand Down
Loading