From bf7933a0335cc9f6635f85986d2c72b3153a6ce0 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 18 Dec 2024 16:41:49 -0500 Subject: [PATCH] Update tv_mode.md (#26833) * Update tv_mode.md * Update content/en/dashboards/guide/tv_mode.md * Apply suggestions from code review Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --------- Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --- content/en/dashboards/guide/tv_mode.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/dashboards/guide/tv_mode.md b/content/en/dashboards/guide/tv_mode.md index 346cc832590fd..6d5c1ec20f891 100644 --- a/content/en/dashboards/guide/tv_mode.md +++ b/content/en/dashboards/guide/tv_mode.md @@ -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