Struct Span 

pub struct Span<'a> {
    pub text: &'a str,
    pub color: Option<Color>,
    pub bold: bool,
    pub italic: bool,
    pub underline: bool,
    pub underline_color: Option<Color>,
    pub underline_style: UnderlineStyle,
    pub strikethrough: bool,
    pub bg: Option<Color>,
    pub bg_radius: f32,
}

One styled run inside a rich-text paragraph. Spans are shaped and wrapped together as a single flow; plain data, so every frontend can build them.

Fields

text: &'a str

color: Option<Color>

bold: bool

italic: bool

underline: bool

A line under the span, where the face puts its underline (backlog C22).

underline_color: Option<Color>

The underline’s own colour; None is the span’s (backlog K4).

underline_style: UnderlineStyle

The underline’s shape (backlog K4).

strikethrough: bool

A line through the span, where the face puts its strikeout.

bg: Option<Color>

A background behind the span’s glyphs, one rect per line it spans, so it follows the span across a wrap the way a box cannot.

bg_radius: f32

The background’s corner radius, logical px (backlog F101). Above zero, every background of the same colour and radius that meets another edge to edge on the line above or below — in this text or another — is one shape with it: its corners convex where a line reaches past its neighbour, concave where it falls short, round where nothing meets it. What a selection over lines looks like.

Implementations

impl<'a> Span<'a>

pub fn new(text: &'a str) -> Span<'a>

pub fn color(self, c: Color) -> Span<'a>

pub fn bold(self) -> Span<'a>

pub fn italic(self) -> Span<'a>

pub fn underline(self) -> Span<'a>

pub fn underline_color(self, c: Color) -> Span<'a>

An underline in its own colour (backlog K4); turns it on.

pub fn underline_style(self, s: UnderlineStyle) -> Span<'a>

An underline of this shape (backlog K4); turns it on.

pub fn strikethrough(self) -> Span<'a>

pub fn bg(self, c: Color) -> Span<'a>

pub fn bg_radius(self, r: f32) -> Span<'a>

Rounds the background, joined with the ones it meets (see Span::bg_radius).

Trait Implementations

impl<'a> Clone for Span<'a>

fn clone(&self) -> Span<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Span<'a>

impl<'a> Debug for Span<'a>

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

Formats the value using the given formatter.