Struct Line 

pub struct Line { /* private fields */ }

A single line of styled terminal output, composed of Spans.

Each Span carries its own Style, so a single Line can mix colors, bold, italic, etc. ANSI escape codes are emitted only when to_ansi_string is called, keeping the data model free of formatting concerns.

Construction

use tui::{Line, Style, Color};

// Plain text
let line = Line::new("hello");

// Single color
let line = Line::styled("error", Color::Red);

// Full style
let line = Line::with_style("warning", Style::fg(Color::Yellow).bold());

// Incremental building
let mut line = Line::default();
line.push_text("Name: ");
line.push_styled("Alice", Color::Cyan);

Key methods

• push_span(span) — Append a Span. Merges with the last span if styles match.
• push_text(text) / push_styled(text, color) / push_with_style(text, style) — Convenience wrappers over push_span.
• prepend(text) — Insert unstyled text at the front, inheriting background color or fill style from the line.
• append_line(other) — Append all spans from another Line.
• display_width() — Width in terminal columns (accounts for Unicode).
• soft_wrap(width) — Break into multiple Lines fitting within width columns. Fill metadata is propagated to each wrapped row.
• to_ansi_string() — Emit the line as an ANSI-escaped string.
• extend_bg_to_width(target) — Pad with spaces to fill target columns. If with_fill was called, that color is consumed for the padding; otherwise the existing span background is reused.

Row fill (deferred padding)

A row can be marked with a fill background that tells later layout stages “extend this row to its containing width with trailing spaces in this color.” Materialization is deferred until either Frame::hstack (per slot width) or VisualFrame::from_frame (per terminal width) needs it. This avoids the trailing-space wrap artifact: a fill-marked row that gets soft-wrapped at a smaller width does not produce phantom rows from the would-be padding spaces.

• with_fill(color) — Builder: mark this row as filling its containing width with color.
• set_fill(Option<Color>) — Set or clear the row’s fill background; pass None to drop existing fill.
• fill() — Inspect the current fill background as Option<Color>.

Line implements Display for plain-text output (no ANSI codes).

Implementations

impl Line

pub fn new(s: impl Into<String>) -> Self

pub fn styled(text: impl Into<String>, color: Color) -> Self

pub fn with_style(text: impl Into<String>, style: Style) -> Self

pub fn spans(&self) -> &[Span]

pub fn is_empty(&self) -> bool

pub fn fill(&self) -> Option<Color>

Returns this row’s fill background, if any.

pub fn with_fill(self, color: Color) -> Self

Builder: mark this row as filling its containing width with color.

pub fn set_fill(&mut self, fill: Option<Color>)

Set or clear this row’s fill background. Pass Some(color) to mark the row for fill, or None to drop any existing fill metadata.

pub fn infer_fill_color(&self) -> Option<Color>

The background color this row’s trailing space would be filled with.

Prefers explicit fill metadata, otherwise the first background color found among the row’s spans, otherwise None. Used by composition layers (e.g., Frame::fit with with_fill) to decide what background to extend.

pub fn prepend(self, text: impl Into<String>) -> Self

pub fn push_text(&mut self, text: impl Into<String>)

pub fn push_styled(&mut self, text: impl Into<String>, color: Color)

pub fn push_with_style(&mut self, text: impl Into<String>, style: Style)

pub fn push_span(&mut self, span: Span)

pub fn append_line(&mut self, other: &Line)

pub fn extend_bg_to_width(&mut self, target_width: usize)

pub fn to_ansi_string(&self) -> String

pub fn display_width(&self) -> usize

Display width in terminal columns (accounts for unicode widths).

pub fn soft_wrap(&self, width: u16) -> Vec<Line>

Soft-wrap this line to fit within width columns.

pub fn plain_text(&self) -> String

Trait Implementations

impl Clone for Line

fn clone(&self) -> Line

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Line

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

Formats the value using the given formatter.

impl Default for Line

fn default() -> Line

Returns the “default value” for a type.

impl Display for Line

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

Formats the value using the given formatter.

impl PartialEq for Line

fn eq(&self, other: &Line) -> 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 Eq for Line

impl StructuralPartialEq for Line