Enum ScreenBackground 

pub enum ScreenBackground {
    Transparent,
    Theme,
    Custom(Style),
}

How the root viewport background is painted before the UI tree renders.

By default the framework paints nothing behind the tree, so the host terminal background shows through (Transparent). Opt into a filled background when you want a fully “designed” surface rather than text floating on the terminal color — useful for kiosk-style apps, themes with a strong identity, or matching a brand backdrop.

use tui_lipan::prelude::*;

// Fill with the active theme's backdrop surface:
let app = App::new().theme(Theme::lipan()).fill_background();

// Or an explicit color:
let app = App::new().screen_background(Color::hex_u24(0x04090D));

Variants

Transparent

Leave the host terminal background untouched. (default)

Theme

Fill the viewport with the active root theme’s backdrop surface (Theme::surface.backdrop).

This tracks the theme of the realized root node, so apps that swap themes at runtime via a root ThemeProvider (rather than rebuilding the App) keep the backdrop in sync without any extra wiring.

Custom(Style)

Fill the viewport with an explicit style (typically just a background color).

Trait Implementations

impl Clone for ScreenBackground

fn clone(&self) -> ScreenBackground

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ScreenBackground

impl Debug for ScreenBackground

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ScreenBackground

fn default() -> ScreenBackground

Returns the “default value” for a type.

impl From<Color> for ScreenBackground

fn from(color: Color) -> Self

Converts to this type from the input type.

impl From<Paint> for ScreenBackground

fn from(paint: Paint) -> Self

Converts to this type from the input type.

impl From<Style> for ScreenBackground

fn from(style: Style) -> Self

Converts to this type from the input type.

impl PartialEq for ScreenBackground

fn eq(&self, other: &ScreenBackground) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ScreenBackground