FontFamily

Purpose

Sans-serif, serif, monospace, or a font registered by name.

Signature

pub enum FontFamily {
    /// The application's default sans-serif — what text gets when it says nothing.
    SansSerif,
    /// A serif face, if the platform or the application has one.
    Serif,
    /// The registered monospaced family: code, keys, anything whose columns must line up.
    Monospace,
    /// A family **by name**, as registered with `frus_text::add_font`.
    Named(&'static str),
}

Example

From frus-examples/widgets/src/features/text/widgets/font_family.rs:

//! `FontFamily` — which typeface a text is set in: the default sans-serif, a serif, the
//! monospace face, or a font you registered by name.

use frus::{Align, Column, FontFamily, Text, TextStyle, Widget};

use crate::common::shared::{section, sections};

const SAMPLE: &str = "The quick brown fox jumps over the lazy dog";

pub fn example() -> Box<dyn Widget> {
    sections(vec![
        // What text gets when it says nothing.
        Box::new(section(
            "SansSerif (the default)",
            Text::new(SAMPLE).family(FontFamily::SansSerif),
        )),
        // A serif face, where the platform or the application has one; otherwise the
        // default is used.
        Box::new(section(
            "Serif",
            Text::new(SAMPLE).family(FontFamily::Serif),
        )),
        // Monospace: every character the same width, so columns line up — code, keys,
        // tables of numbers.
        Box::new(section(
            "Monospace",
            Column::new()
                .cross_axis_alignment(Align::Start)
                .spacing(2.0)
                .child(Text::new("fn main() {").family(FontFamily::Monospace))
                .child(Text::new("    println!(\"hi\");").family(FontFamily::Monospace))
                .child(Text::new("}").family(FontFamily::Monospace))
                .child(Text::new("1 111.00").family(FontFamily::Monospace))
                .child(Text::new("   42.50").family(FontFamily::Monospace)),
        )),
        // Your own font: register its bytes once at start-up with
        // `frus::fonts::add_font(include_bytes!("../res/fonts/Brand.ttf").to_vec())`, then
        // name its family. A name that matches no font falls back to the default rather
        // than showing nothing — as this one does.
        Box::new(section(
            "Named (falls back when missing)",
            Text::styled(
                SAMPLE,
                TextStyle::NONE.family(FontFamily::Named("Brand Sans")),
            ),
        )),
    ])
}

Properties

No builder methods: everything is set through the constructor.

Behaviour

A font family, as a style names it.

Copy, and Named holds a &'static str, so that a TextStyle stays Copy and can be handed down a subtree by value like every other field. Family names come from frus_text::add_font, which registers them for the life of the program, so a borrowed name outliving the style is the normal case rather than a restriction.

See also

• RichText & TextSpan: one paragraph in several styles, from a tree of spans.
• Text theme: the app's type scale, from display_large to label_small, and headings.
• Selectable text & SelectionArea: text the reader can select and copy, alone or across several texts.
• Kbd: a keyboard key cap, for showing shortcuts.
• The guide: Text, colour and the theme
• API reference: FontFamily

Source: crates/frus-core/src/text_style.rs @ e6fba33f5b42