Enum Attribute

#[non_exhaustive]
pub enum Attribute {
    Reset,
    Bold,
    Dim,
    Italic,
    Underlined,
    DoubleUnderlined,
    Undercurled,
    Underdotted,
    Underdashed,
    SlowBlink,
    RapidBlink,
    Reverse,
    Hidden,
    CrossedOut,
    Fraktur,
    NoBold,
    NormalIntensity,
    NoItalic,
    NoUnderline,
    NoBlink,
    NoReverse,
    NoHidden,
    NotCrossedOut,
    Framed,
    Encircled,
    OverLined,
    NotFramedOrEncircled,
    NotOverLined,
}

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.

Usage:

Check crate::Cell::add_attribute on how to use it.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Reset

Resets all the attributes.

Bold

Increases the text intensity.

Dim

Decreases the text intensity.

Italic

Emphasises the text.

Underlined

Underlines the text.

DoubleUnderlined

Double underlines the text.

Undercurled

Undercurls the text.

Underdotted

Underdots the text.

Underdashed

Underdashes 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.

Trait Implementations

impl Clone for Attribute

fn clone(&self) -> Attribute

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Attribute

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

Formats the value using the given formatter.

impl Hash for Attribute

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 Ord for Attribute

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Attribute

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

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Copy for Attribute

impl Eq for Attribute

impl StructuralPartialEq for Attribute