Struct TextArgs

pub struct TextArgs {
    pub text: String,
    pub color: Color,
    pub size: Dp,
    pub line_height: Option<Dp>,
}

Configuration arguments for the text component.

TextArgs defines the visual properties and content for rendering text in the Tessera UI framework. It uses the builder pattern for convenient construction and provides sensible defaults for all styling properties.

Fields

• text: The string content to be displayed
• color: Text color (defaults to black)
• size: Font size in density-independent pixels (defaults to 25.0 dp)
• line_height: Optional line height override (defaults to 1.2 × font size)

Builder Pattern

This struct uses the derive_builder crate to provide a fluent builder API. All fields except text have sensible defaults, making it easy to create text with minimal configuration.

Examples

Basic text with defaults

use tessera_ui_basic_components::text::{TextArgs, TextArgsBuilder};

let args = TextArgsBuilder::default()
    .text("Hello, World!".to_string())
    .build()
    .unwrap();
// Uses: black color, 25.0 dp size, 30.0 dp line height (1.2 × size)

Customized text styling

use tessera_ui_basic_components::text::{TextArgs, TextArgsBuilder};
use tessera_ui::{Color, Dp};

let args = TextArgsBuilder::default()
    .text("Styled Text".to_string())
    .color(Color::from_rgb(0.2, 0.4, 0.8)) // Blue color
    .size(Dp(32.0))                        // Larger font
    .line_height(Dp(40.0))                 // Custom line height
    .build()
    .unwrap();

Using automatic line height calculation

use tessera_ui_basic_components::text::{TextArgs, TextArgsBuilder};
use tessera_ui::Dp;

let args = TextArgsBuilder::default()
    .text("Auto Line Height".to_string())
    .size(Dp(50.0))
    // line_height will automatically be Dp(60.0) (1.2 × 50.0)
    .build()
    .unwrap();

Converting from string types

use tessera_ui_basic_components::text::TextArgs;

// From String
let args1: TextArgs = "Hello".to_string().into();

// From &str
let args2: TextArgs = "World".into();

Fields

text: String

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.

color: Color

The color of the text.

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

size: Dp

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.

line_height: Option<Dp>

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();

Trait Implementations

impl Clone for TextArgs

fn clone(&self) -> TextArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextArgs

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

Formats the value using the given formatter.

impl Default for TextArgs

fn default() -> TextArgs

Returns the “default value” for a type.

impl From<&str> for TextArgs

Converts a string slice (&str) into TextArgs using the builder pattern.

This enables ergonomic conversion from string literals for the text component.

Example

use tessera_ui_basic_components::text::TextArgs;

let args: TextArgs = "Quick text".into();

fn from(val: &str) -> Self

Converts to this type from the input type.

impl From<String> for TextArgs

Converts a String into TextArgs using the builder pattern.

This allows convenient usage of string literals or owned strings as text arguments for the text component.

Example

use tessera_ui_basic_components::text::TextArgs;

let args: TextArgs = "Hello, Tessera!".to_string().into();

fn from(val: String) -> Self

Converts to this type from the input type.