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() -> Self

Create an empty style (all properties inherit).

pub fn fg<C: Into<PackedRgba>>(self, color: C) -> Self

Set foreground color.

pub fn bg<C: Into<PackedRgba>>(self, color: C) -> Self

Set background color.

pub fn bold(self) -> Self

Add bold attribute.

pub fn italic(self) -> Self

Add italic attribute.

pub fn underline(self) -> Self

Add underline attribute.

pub fn dim(self) -> Self

Add dim attribute.

pub fn reverse(self) -> Self

Add reverse video attribute.

pub fn strikethrough(self) -> Self

Add strikethrough attribute.

pub fn blink(self) -> Self

Add blink attribute.

pub fn hidden(self) -> Self

Add hidden attribute.

pub fn double_underline(self) -> Self

Add double underline attribute.

pub fn curly_underline(self) -> Self

Add curly underline attribute.

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

Set underline color.

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

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

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: Hasher>(&self, state: &mut __H)

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