Struct Span 

pub struct Span {
    pub text: String,
    pub style: Style,
    pub hyperlink: Option<Arc<str>>,
}

A run of text with a uniform style.

Spans are concatenated before grapheme segmentation so clusters may cross a span boundary. Keep style boundaries on grapheme-cluster boundaries when predictable per-cluster styling matters.

Fields

text: String

Plain text belonging to this span.

style: Style

Style associated with text in this span.

If a rendered grapheme cluster crosses span boundaries, StyledText uses the style at the cluster’s first scalar value.

hyperlink: Option<Arc<str>>

Sanitized OSC 8 target for this span, when present.

Implementations

impl Span

pub fn new(text: impl Into<String>, style: Style) -> Span

Creates a span with explicit text and style.

pub fn plain(text: impl Into<String>) -> Span

Creates an unstyled span.

pub fn hyperlink(self, target: impl AsRef<str>) -> Span

Returns this span with an OSC 8 target when the target is safe.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Span

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

Formats the value using the given formatter.

impl Eq for Span

impl From<Span> for StyledText

fn from(span: Span) -> StyledText

Converts to this type from the input type.

impl PartialEq for Span

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Span