Enum comfy_table::Attribute

pub enum Attribute {
    Reset,
    Bold,
    Dim,
    Italic,
    Underlined,
    SlowBlink,
    RapidBlink,
    Reverse,
    Hidden,
    CrossedOut,
    Fraktur,
    NoBold,
    NormalIntensity,
    NoItalic,
    NoUnderline,
    NoBlink,
    NoReverse,
    NoHidden,
    NotCrossedOut,
    Framed,
    Encircled,
    OverLined,
    NotFramedOrEncircled,
    NotOverLined,
}

Attributes used for styling cell content. Reexport of crossterm's Attributes enum. Represents an attribute.

Platform-specific Notes

• Only UNIX and Windows 10 terminals do support text attributes.
• Keep in mind that not all terminals support all attributes.
• Crossterm implements almost all attributes listed in the SGR parameters.

Attribute	Windows	UNIX	Notes
Reset	✓	✓
Bold	✓	✓
Dim	✓	✓
Italic	?	?	Not widely supported, sometimes treated as inverse.
Underlined	✓	✓
SlowBlink	?	?	Not widely supported, sometimes treated as inverse.
RapidBlink	?	?	Not widely supported. MS-DOS ANSI.SYS; 150+ per minute.
Reverse	✓	✓
Hidden	✓	✓	Also known as Conceal.
Fraktur	✗	✓	Legible characters, but marked for deletion.
DefaultForegroundColor	?	?	Implementation specific (according to standard).
DefaultBackgroundColor	?	?	Implementation specific (according to standard).
Framed	?	?	Not widely supported.
Encircled	?	?	This should turn on the encircled attribute.
OverLined	?	?	This should draw a line at the top of the text.

Examples

Basic usage:

use crossterm::style::Attribute;

println!(
    "{} Underlined {} No Underline",
    Attribute::Underlined,
    Attribute::NoUnderline
);

Style existing text:

use crossterm::style::Styler;

println!("{}", "Bold text".bold());
println!("{}", "Underlined text".underlined());
println!("{}", "Negative text".negative());

Variants

Reset

Resets all the attributes.

Bold

Increases the text intensity.

Dim

Decreases the text intensity.

Italic

Emphasises the text.

Underlined

Underlines the text.

SlowBlink

Makes the text blinking (< 150 per minute).

RapidBlink

Makes the text blinking (>= 150 per minute).

Reverse

Swaps foreground and background colors.

Hidden

Hides the text (also known as Conceal).

CrossedOut

Crosses the text.

Fraktur

Sets the Fraktur typeface.

Mostly used for mathematical alphanumeric symbols.

NoBold

Turns off the Bold attribute. - Inconsistent - Prefer to use NormalIntensity

NormalIntensity

Switches the text back to normal intensity (no bold, italic).

NoItalic

Turns off the Italic attribute.

NoUnderline

Turns off the Underlined attribute.

NoBlink

Turns off the text blinking (SlowBlink or RapidBlink).

NoReverse

Turns off the Reverse attribute.

NoHidden

Turns off the Hidden attribute.

NotCrossedOut

Turns off the CrossedOut attribute.

Framed

Makes the text framed.

Encircled

Makes the text encircled.

OverLined

Draws a line at the top of the text.

NotFramedOrEncircled

Turns off the Frame and Encircled attributes.

NotOverLined

Turns off the OverLined attribute.

Implementations

impl Attribute

Attributes used for styling cell content. Reexport of crossterm's Attributes enum.

pub const fn bytes(self) -> u32

Returns a u32 with one bit set, which is the signature of this attribute in the Attributes bitset.

The +1 enables storing Reset (whose index is 0) in the bitset Attributes.

pub fn sgr(self) -> i16

Returns the SGR attribute value.

See https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters

impl Attribute

Attributes used for styling cell content. Reexport of crossterm's Attributes enum.

pub fn iterator() -> impl Iterator<Item = Attribute>

Iterates over all the variants of the Attribute enum.

Trait Implementations

impl Clone for Attribute

pub fn clone(&self) -> Attribute

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Attribute

impl Debug for Attribute

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

Formats the value using the given formatter.

impl Display for Attribute

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

Formats the value using the given formatter.

impl Eq for Attribute

impl Hash for Attribute

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Ord for Attribute

pub fn cmp(&self, other: &Attribute) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<Attribute> for Attribute

pub fn eq(&self, other: &Attribute) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<Attribute> for Attribute

pub fn partial_cmp(&self, other: &Attribute) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for Attribute

impl StructuralPartialEq for Attribute