Struct FontFace 

pub struct FontFace { /* private fields */ }

Layer 0 of the font model, re-exported for the same one-dependency reason.

A build script composing an override needs all four names and has no other reason to depend on makeover directly. One @font-face an override brings with it.

A product overriding a slot usually has to ship the face too, and the two halves have to agree on a family name. Declaring them together is what makes that agreement structural rather than a string typed twice.

Implementations

impl FontFace

pub fn new<S>( family: impl Into<String>, sources: impl IntoIterator<Item = S>, ) -> FontFace

where S: Into<String>,

A face named family, fetched from sources.

Each source is either a bare filename, resolved against the Typography base URL, or an absolute one (/… or https://…) taken as written. The format() hint is inferred from the extension (woff2, woff, ttf, otf) and omitted for anything else rather than guessed, since a wrong hint is worse than none.

pub fn with_weight(self, weight: impl Into<String>) -> FontFace

font-weight, as CSS writes it: "700", or "200 800" for a variable axis. Omitted when unset, which means normal.

A variable face MUST name its range here for the same reason the house faces do: a @font-face with no range makes the browser resolve every weight to the file’s default instance.

pub fn with_style(self, style: impl Into<String>) -> FontFace

font-style. Omitted when unset, which means normal.

pub fn weight(&self) -> Option<&str>

The declared font-weight, or None when the face never named one.

A renderer loading a variable face directly has to name a weight (the file’s own default instance is whatever the base shipped, which for the house faces is ExtraLight), so this is the half of the declaration that stops the load from being a guess.

pub fn style(&self) -> Option<&str>

The declared font-style, or None, which means normal.

pub fn family(&self) -> &str

The family name, as the stack has to spell it.

For a renderer that loads faces rather than emitting CSS this is the name it registers the file under, and reading it here is what keeps that name from being typed a second time.

pub fn sources(&self) -> &[String]

The sources, unresolved: bare filenames as they were declared, not joined to any base URL. A renderer loading from disk or from an include_bytes! wants the filename; only the CSS wants the URL.

Trait Implementations

impl Clone for FontFace

fn clone(&self) -> FontFace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontFace

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

Formats the value using the given formatter.