Struct Style 

pub struct Style {
    pub fg: Option<PackedRgba>,
    pub bg: Option<PackedRgba>,
    pub attrs: Option<StyleFlags>,
    pub underline_color: Option<PackedRgba>,
}

Unified styling type with CSS-like cascading semantics.

Design Rationale

• Option fields allow inheritance (None = inherit from parent)
• Explicit masks track which properties are intentionally set
• Copy + small size for cheap passing
• Builder pattern for ergonomic construction

Example

use ftui_style::{Style, StyleFlags};
use ftui_render::cell::PackedRgba;

let style = Style::new()
    .fg(PackedRgba::rgb(255, 0, 0))
    .bg(PackedRgba::rgb(0, 0, 0))
    .bold()
    .underline();

Fields

fg: Option<PackedRgba>

Foreground color (text color).

bg: Option<PackedRgba>

Background color.

attrs: Option<StyleFlags>

Text attributes (bold, italic, etc.).

underline_color: Option<PackedRgba>

Underline color (separate from fg for flexibility).

Implementations

impl Style

pub const fn new() -> Style

Create an empty style (all properties inherit).

pub fn fg<C>(self, color: C) -> Style

where C: Into<PackedRgba>,

Set foreground color.

pub fn bg<C>(self, color: C) -> Style

where C: Into<PackedRgba>,

Set background color.

pub fn bold(self) -> Style

Add bold attribute.

pub fn italic(self) -> Style

Add italic attribute.

pub fn underline(self) -> Style

Add underline attribute.

pub fn dim(self) -> Style

Add dim attribute.

pub fn reverse(self) -> Style

Add reverse video attribute.

pub fn strikethrough(self) -> Style

Add strikethrough attribute.

pub fn blink(self) -> Style

Add blink attribute.

pub fn hidden(self) -> Style

Add hidden attribute.

pub fn double_underline(self) -> Style

Add double underline attribute.

pub fn curly_underline(self) -> Style

Add curly underline attribute.

pub const fn underline_color(self, color: PackedRgba) -> Style

Set underline color.

pub const fn attrs(self, attrs: StyleFlags) -> Style

Set attributes directly.

pub fn merge(&self, parent: &Style) -> Style

Cascade merge: Fill in None fields from parent.

child.merge(parent) returns a style where child’s Some values take precedence, and parent fills in any None values.

For attributes, the flags are combined (OR operation) so both parent and child attributes apply.

Example

use ftui_style::Style;
use ftui_render::cell::PackedRgba;

let parent = Style::new().fg(PackedRgba::rgb(255, 0, 0)).bold();
let child = Style::new().bg(PackedRgba::rgb(0, 0, 255));
let merged = child.merge(&parent);
// merged has: fg=RED (from parent), bg=BLUE (from child), bold (from parent)

pub fn patch(&self, child: &Style) -> Style

Patch merge: Override parent with child’s Some values.

parent.patch(&child) returns a style where child’s Some values replace parent’s values.

This is the inverse perspective of merge().

pub const fn is_empty(&self) -> bool

Check if this style has any properties set.

pub fn has_attr(&self, flag: StyleFlags) -> bool

Check if a specific attribute is set.

Trait Implementations

impl Clone for Style

fn clone(&self) -> Style

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Style

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

Formats the value using the given formatter.

impl Default for Style

fn default() -> Style

Returns the “default value” for a type.

impl Hash for Style

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Style

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

impl Eq for Style

impl StructuralPartialEq for Style