Struct StyleSheet 

pub struct StyleSheet { /* private fields */ }

A registry of named styles for consistent theming.

StyleSheet allows defining styles by name and looking them up later. This decouples visual appearance from widget logic, allowing themes to override the stylesheet without changing widget code.

Thread Safety

StyleSheet uses an internal RwLock for thread-safe read access after initialization. Multiple readers can access styles concurrently.

Implementations

impl StyleSheet

pub fn new() -> Self

Create a new empty StyleSheet.

pub fn with_defaults() -> Self

Create a StyleSheet with default semantic styles.

This provides a base set of commonly-used style names:

• error: Red, bold
• warning: Orange/yellow
• info: Blue
• success: Green
• muted: Gray/dim
• highlight: Yellow background
• link: Blue, underline

pub fn define(&self, name: impl Into<String>, style: Style)

Define a named style.

If a style with this name already exists, it is replaced.

pub fn remove(&self, name: &str) -> Option<Style>

Remove a named style.

Returns the removed style if it existed.

pub fn get(&self, name: &str) -> Option<Style>

Get a named style.

Returns None if the style is not defined.

pub fn get_or_default(&self, name: &str) -> Style

Get a named style, returning a default if not found.

pub fn contains(&self, name: &str) -> bool

Check if a style with the given name exists.

pub fn len(&self) -> usize

Get the number of defined styles.

pub fn is_empty(&self) -> bool

Check if the stylesheet is empty.

pub fn names(&self) -> Vec<String>

Get all style names.

pub fn compose(&self, names: &[&str]) -> Style

Compose multiple styles by name, merging them in order.

Styles are merged left-to-right, with later styles taking precedence over earlier ones for conflicting properties.

Missing style names are silently ignored.

Example

use ftui_style::{Style, StyleSheet};
use ftui_render::cell::PackedRgba;

let sheet = StyleSheet::new();
sheet.define("base", Style::new().fg(PackedRgba::WHITE));
sheet.define("bold", Style::new().bold());

// Compose: base + bold = white text that's bold
let composed = sheet.compose(&["base", "bold"]);

pub fn compose_strict(&self, names: &[&str]) -> Option<Style>

Compose styles with fallback for missing names.

Like compose, but returns None if any named style is missing.

pub fn extend(&self, other: &StyleSheet)

Extend this stylesheet with styles from another.

Styles from other override styles with the same name in self.

pub fn clear(&self)

Clear all styles from the stylesheet.

Trait Implementations

impl Clone for StyleSheet

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StyleSheet

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

Formats the value using the given formatter.

impl Default for StyleSheet

fn default() -> StyleSheet

Returns the “default value” for a type.