Struct Style 

pub struct Style { /* private fields */ }

A style definition for rendering terminal content.

Style uses a builder pattern for easy chaining:

use lacquer::{Style, Border, Position, Color};

let style = Style::new()
    .padding(1, 2)
    .margin(0, 1)
    .border(Border::Rounded)
    .foreground(Color::from_hex("#F97316"))
    .background(Color::from_hex("#0A0A0A"))
    .bold()
    .width(40)
    .align(Position::Center);

Implementations

impl Style

pub const fn new() -> Self

Create a new empty style.

pub const fn padding_all(self, padding: u16) -> Self

Set uniform padding on all sides.

pub const fn padding(self, vertical: u16, horizontal: u16) -> Self

Set vertical and horizontal padding.

pub const fn padding_sides( self, top: u16, right: u16, bottom: u16, left: u16, ) -> Self

Set padding for each side individually.

pub const fn padding_top(self, padding: u16) -> Self

Set top padding.

pub const fn padding_right(self, padding: u16) -> Self

Set right padding.

pub const fn padding_bottom(self, padding: u16) -> Self

Set bottom padding.

pub const fn padding_left(self, padding: u16) -> Self

Set left padding.

pub const fn margin_all(self, margin: u16) -> Self

Set uniform margin on all sides.

pub const fn margin(self, vertical: u16, horizontal: u16) -> Self

Set vertical and horizontal margin.

pub const fn margin_sides( self, top: u16, right: u16, bottom: u16, left: u16, ) -> Self

Set margin for each side individually.

pub const fn width(self, width: u16) -> Self

Set fixed width.

pub const fn height(self, height: u16) -> Self

Set fixed height.

pub const fn max_width(self, max: u16) -> Self

Set maximum width.

pub const fn max_height(self, max: u16) -> Self

Set maximum height.

pub const fn border(self, border: Border) -> Self

Set border style.

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

Set uniform border color.

pub fn border_foreground_hex(self, hex: &str) -> Self

Set border color from a hex string.

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

Set foreground (text) color.

Accepts a Color, hex string, or RGB values.

use lacquer::{Style, Color};

let s1 = Style::new().foreground(Color::Red);
let s2 = Style::new().foreground(Color::from_hex("#F97316"));
let s3 = Style::new().foreground(Color::rgb(249, 115, 22));

pub fn foreground_hex(self, hex: &str) -> Self

Set foreground color from a hex string.

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

Set background color.

pub fn background_hex(self, hex: &str) -> Self

Set background color from a hex string.

pub const fn bold(self) -> Self

Enable bold text.

pub const fn italic(self) -> Self

Enable italic text.

pub const fn underline(self) -> Self

Enable underlined text.

pub const fn strikethrough(self) -> Self

Enable strikethrough text.

pub const fn dim(self) -> Self

Enable dim/faint text.

pub const fn reverse(self) -> Self

Enable reverse video (swap fg/bg).

pub const fn align(self, position: Position) -> Self

Set horizontal alignment.

pub const fn vertical_align(self, position: Position) -> Self

Set vertical alignment.

pub const fn inline(self) -> Self

Enable inline mode (no block wrapping).

pub fn render(&self, content: &str) -> String

Render content with this style applied.

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.