Struct Text 

pub struct Text {
    pub spans: Vec<Span>,
    pub alignment: Alignment,
    pub overflow: Overflow,
    pub style: Style,
}

A text container with multiple styled spans.

Fields

spans: Vec<Span>

The spans that make up this text

alignment: Alignment

Text alignment

overflow: Overflow

Overflow behavior

style: Style

Optional style applied to the whole text

Implementations

impl Text

pub fn new() -> Self

Create a new empty text.

pub fn plain<S: Into<Cow<'static, str>>>(text: S) -> Self

Create text from a plain string.

pub fn styled<S: Into<Cow<'static, str>>>(text: S, style: Style) -> Self

Create text from a styled string.

pub fn from_spans<I: IntoIterator<Item = Span>>(spans: I) -> Self

Create text from multiple spans.

pub fn push_span(&mut self, span: Span)

Add a span to the text.

pub fn push<S: Into<Cow<'static, str>>>(&mut self, text: S)

Append plain text.

pub fn push_styled<S: Into<Cow<'static, str>>>(&mut self, text: S, style: Style)

Append styled text.

pub fn alignment(self, alignment: Alignment) -> Self

Set the alignment.

pub fn overflow(self, overflow: Overflow) -> Self

Set the overflow behavior.

pub fn style(self, style: Style) -> Self

Set the overall style.

pub fn width(&self) -> usize

Get the total display width (without line breaks).

pub fn plain_text(&self) -> String

Get the plain text content without styling.

pub fn is_empty(&self) -> bool

Check if the text is empty.

pub fn wrap(&self, width: usize) -> Vec<Vec<Span>>

Split the text into lines, wrapping at the given width.

pub fn align_line(&self, line: Vec<Span>, width: usize) -> Vec<Span>

Apply alignment to a line, returning padded spans.

Trait Implementations

impl Clone for Text

fn clone(&self) -> Text

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Text

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

Formats the value using the given formatter.

impl Default for Text

fn default() -> Text

Returns the “default value” for a type.

impl<S: Into<Cow<'static, str>>> From<S> for Text

fn from(text: S) -> Self

Converts to this type from the input type.

impl Renderable for Text

Implement Renderable for Text.

fn render(&self, context: &RenderContext) -> Vec<Segment>

Render this object to a sequence of segments.

fn min_width(&self) -> usize

Get the minimum width required to render this object.

fn max_width(&self) -> usize

Get the maximum/natural width of this object.