Struct TextArgsBuilder

pub struct TextArgsBuilder { /* private fields */ }

Builder for TextArgs.

Implementations

impl TextArgsBuilder

pub fn text(self, value: String) -> Self

The text content to be rendered.

This is the actual string that will be displayed on screen. It can contain Unicode characters and will be rendered using the specified font properties.

pub fn color(self, value: Color) -> Self

The color of the text.

Defaults to Color::BLACK if not specified. The color is applied uniformly to all characters in the text string.

pub fn size(self, value: Dp) -> Self

The font size in density-independent pixels (dp).

Defaults to Dp(25.0) if not specified. This size is automatically scaled based on the device’s pixel density to ensure consistent visual appearance across different screen densities.

pub fn line_height(self, value: Dp) -> Self

Optional override for line height in density-independent pixels (dp).

If not specified (None), the line height will automatically be calculated as 1.2 times the font size, which provides good readability for most text.

Set this to a specific value if you need precise control over line spacing, such as for dense layouts or specific design requirements.

Example

use tessera_ui_basic_components::text::TextArgsBuilder;
use tessera_ui::Dp;

// Automatic line height (1.2 × size)
let auto = TextArgsBuilder::default()
    .text("Auto spacing".to_string())
    .size(Dp(20.0))  // line_height will be Dp(24.0)
    .build()
    .unwrap();

// Custom line height
let custom = TextArgsBuilder::default()
    .text("Custom spacing".to_string())
    .size(Dp(20.0))
    .line_height(Dp(30.0))  // Explicit line height
    .build()
    .unwrap();

pub fn build(self) -> Result<TextArgs, TextArgsBuilderError>

Builds a new TextArgs.

Errors

If a required field has not been initialized.

Trait Implementations

impl Default for TextArgsBuilder

fn default() -> Self

Returns the “default value” for a type.