Struct RichText 

pub struct RichText { /* private fields */ }

Text with a little formatting, written the way chat apps write it: *bold*, _italic_, ~struck~, `code`, a fenced block of ```, lines that start with * , - or > , and web addresses, which become links.

It wraps to the width it is offered, between words, and a marked piece stays with the punctuation around it. Text with nothing to format is drawn as one Text, for the same cost. Links take the keyboard: Tab reaches them, and Enter or Space opens them. It only recognizes http and https, and it hands the address to Self::on_link instead of opening anything.

ravenrs-text shapes one style per text and embeds neither an italic nor a monospace font, so italics are told apart by a muted color and code by a chip behind it.

use ravenrs_widgets::{RichText, Ui};

let text = RichText::new("*Ready:* see `report.pdf` at https://example.com/r")
    .on_link(|address| println!("open {address}"));
let mut ui = Ui::new(text, ravenrs_style::Theme::raven_dark());
ui.update();

Implementations

impl RichText

pub fn new(text: impl Into<String>) -> RichText

Text that may have marks in it.

pub fn links_only(self) -> RichText

Takes every mark literally, and only finds the links: for text from somewhere that does not use these marks.

pub fn style(self, style: TextStyle) -> RichText

A step of the type scale (Body by default).

pub fn foreground(self, fill: impl Into<Fill>) -> RichText

Text color, as a theme role (Ink by default) or a literal color.

pub fn on_link(self, handler: impl Fn(String) + 'static) -> RichText

Called with the address of a link when it is clicked, or pressed with Enter or Space. Without it, links look like links but cannot be activated or focused.

pub fn plain_text(text: &str) -> String

The text without its marks, on one line: for a preview, such as in a list of conversations.

Trait Implementations

impl Clone for RichText

fn clone(&self) -> RichText

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RichText

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

Formats the value using the given formatter.

impl View for RichText

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.