Tickit...Static(3pm)

💖 Tickit::Widget::Static — bestie edition 💖

okay so this is Tickit::Widget::Static, straight out of the User Contributed Perl Documentation section of the manual (perl 3pm, iykyk). it's giving "put some words on the screen and let them vibe there forever" ✨

---

🌸 NAME 🌸

Tickit::Widget::Static — a widget displaying static text 🎀

---

✨ SYNOPSIS ✨

use Tickit;
use Tickit::Widget::Static;

my $hello = Tickit::Widget::Static->new(
   text   => "Hello, world",
   align  => "centre",
   valign => "middle",
);

Tickit->new( root => $hello )->run;

---

🦋 DESCRIPTION 🦋

so this class hands you a widget that displays, like, one single piece of static text. that's it. that's the whole job. 💅

the text can have more than one line, and you separate those lines with linefeed ("\n") characters. but bestie, listen — no other control sequences are allowed in the string. none. not even a little one. 🙈

---

🎀 STYLE 🎀

the default style pen is what's used as the widget pen. periodt.

lowkey important: the widget pen is mutable, and if you change it, it redraws immediately — slay. BUT 💀 any changes you made will be lost if the widget style gets changed. so don't get attached.

---

🧚 CONSTRUCTOR 🧚

🌈 new

$static = Tickit::Widget::Static->new( %args );

constructs a brand new Tickit::Widget::Static object, no cap.

it takes these named arguments, on top of whatever the base Tickit::Widget constructor already takes:

• text => STRING — the text to display ✨
• align => FLOAT|STRING — optional. defaults to 0.0 if unspecified.
• valign => FLOAT|STRING — optional. defaults to 0.0 if unspecified.
• on_click => CODE — optional. defaults to undef if unspecified.

for more details, peek the accessors below 👇

---

👑 ACCESSORS 👑

💜 text

$text = $static->text;

💜 set_text

$static->set_text( $text );

accessor for the text property — aka the actual text on display in the widget. it's giving "what you see is what's set". 🫶

💜 align

💜 set_align

$align = $static->align;

$static->set_align( $align );

accessor for the horizontal alignment value. 🌈

hand it a value in the range from 0.0 to 1.0 and it aligns the text display within the window. if the window is bigger than the width of the text, it gets aligned according to this value — with 0.0 on the left, 1.0 on the right, and every other value somewhere inbetween. iconic behaviour honestly.

see also Tickit::WidgetRole::Alignable. 🦋

---

💖 AUTHOR 💖

Paul Evans <leonerd@leonerd.org.uk>

---

and that's the whole page, bestie!! 💅 this little writeup is perl v5.40.0, dated 2024-09-16, and it's the Tickit...Static(3pm) page — so like, go forth and align your static text, you absolute main character. mwah 🎀✨