Struct Title 

pub struct Title { /* private fields */ }

A builder for positioning block titles with horizontal alignment and vertical placement.

This struct handles only the positioning of titles (alignment and position), preserving any text styling you’ve already applied. You can style your text separately using TitleStyle or ratatui’s styling features.

Examples

use tui_piechart::title::{Title, TitleStyle};
use tui_piechart::border_style::BorderStyle;

// Simple title with defaults (center top)
let simple = Title::new("Statistics");

// Style text first, then position it
let styled_text = TitleStyle::Bold.apply("Results");
let title = Title::new(styled_text)
    .right()
    .bottom();

// Position plain text
let positioned = Title::new("Dashboard")
    .center()
    .top();

Method Chaining

All builder methods return Self, allowing for fluent method chaining:

use tui_piechart::title::Title;

let title = Title::new("My Chart")
    .center()            // horizontal alignment
    .bottom();           // vertical position

Implementations

impl Title

pub fn new(text: impl Into<String>) -> Self

Creates a new title with the given text and default positioning.

Defaults: Center alignment, Top position

The text is preserved as-is, including any styling you’ve already applied.

pub fn left(self) -> Self

Sets horizontal alignment to Start (left in LTR).

pub fn center(self) -> Self

Sets horizontal alignment to Center.

pub fn right(self) -> Self

Sets horizontal alignment to End (right in LTR).

pub fn top(self) -> Self

Sets vertical position to Top.

pub fn bottom(self) -> Self

Sets vertical position to Bottom.

pub fn render(&self) -> Line<'static>

Returns the text as a Line for rendering (preserves original styling).

pub fn alignment(&self) -> TitleAlignment

Gets the horizontal alignment.

pub fn position(&self) -> TitlePosition

Gets the vertical position.

Trait Implementations

impl Clone for Title

fn clone(&self) -> Title

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Title

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

Formats the value using the given formatter.

impl<T: Into<String>> From<T> for Title

fn from(text: T) -> Self

Converts to this type from the input type.

impl From<Title> for Line<'static>

fn from(title: Title) -> Self

Converts to this type from the input type.

impl PartialEq for Title

fn eq(&self, other: &Title) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Title

impl StructuralPartialEq for Title