Struct Style 

pub struct Style {
    pub fg: Option<Color>,
    pub bg: Option<Color>,
    pub modifiers: Modifiers,
    pub underline_color: Option<Color>,
    pub underline_style: UnderlineStyle,
}

Visual style for a terminal cell (foreground, background, modifiers).

Styles are applied to text via the builder methods on Context widget calls (e.g., .bold(), .fg(Color::Cyan)). All fields are optional; None means “inherit from the terminal default.”

Example

use slt::{Style, Color};

let style = Style::new().fg(Color::Cyan).bold();

Fields

fg: Option<Color>

Foreground color, or None to use the terminal default.

bg: Option<Color>

Background color, or None to use the terminal default.

modifiers: Modifiers

Text modifiers (bold, italic, underline, etc.).

underline_color: Option<Color>

Underline color, or None to use the same color as the foreground.

Emitted as SGR 58 when set and SGR 59 (reset to foreground) when cleared. Requires a terminal that supports separate underline colors.

underline_style: UnderlineStyle

Underline rendering style (straight, curly, dotted, etc.).

Defaults to UnderlineStyle::Straight. Non-straight styles are emitted as CSI 4:Nm and require terminal support.

Implementations

impl Style

pub const fn new() -> Self

Create a new style with no color or modifiers set.

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

Set the foreground color.

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

Set the background color.

pub fn bold(self) -> Self

Add the bold modifier.

pub fn dim(self) -> Self

Add the dim modifier.

pub fn italic(self) -> Self

Add the italic modifier.

pub fn underline(self) -> Self

Add the underline modifier.

pub fn reversed(self) -> Self

Add the reversed (inverted colors) modifier.

pub fn strikethrough(self) -> Self

Add the strikethrough modifier.

pub fn blink(self) -> Self

Add the slow-blink modifier (SGR 5).

pub fn overline(self) -> Self

Add the overline modifier (SGR 53).

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

Set a separate underline color.

Setting this implies the Modifiers::UNDERLINE bit so the underline is actually rendered. Emitted as SGR 58.

Example

use slt::{Color, Modifiers, Style};

let s = Style::new().underline_color(Color::Red);
assert!(s.modifiers.contains(Modifiers::UNDERLINE));

pub const fn underline_style(self, style: UnderlineStyle) -> Self

Set the underline rendering style (straight, curly, dotted, etc.).

Setting a style implies the Modifiers::UNDERLINE bit so the underline is actually rendered. Emitted as CSI 4:Nm.

Example

use slt::{Modifiers, Style, UnderlineStyle};

let s = Style::new().underline_style(UnderlineStyle::Curly);
assert!(s.modifiers.contains(Modifiers::UNDERLINE));

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 Copy for Style

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<'de> Deserialize<'de> for Style

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Style

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Style

Available on crate feature serde only.

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Style