pub struct Text { /* private fields */ }Expand description
A line of text.
The text, elide and max_lines change the layout. Color, font,
alignment, line height and decorations come from the nearest widget
whose Style sets each, starting with the text’s own.
Implementations§
Source§impl Text
impl Text
Sourcepub fn new(text: impl IntoProp<String>) -> Text
pub fn new(text: impl IntoProp<String>) -> Text
Text showing text: a string, or a closure that returns a String.
Sourcepub fn rich(spans: impl IntoProp<Vec<Span>>) -> Text
pub fn rich(spans: impl IntoProp<Vec<Span>>) -> Text
Text made of styled spans: a Vec<Span>, or a closure that returns
one. Each span takes what it doesn’t set from the text, and
everything else a Text takes works the same.
Sourcepub fn on_link(self, handler: impl Fn(&Cx, &str) + 'static) -> Text
pub fn on_link(self, handler: impl Fn(&Cx, &str) + 'static) -> Text
Runs handler with a link span’s URL when a left click lands on
the span’s glyphs. Over a link the cursor is the pointing hand and
the click goes to nothing else, not even a button around the text;
elsewhere the text lets the pointer through as before. In a
selectable text, a press and release on one
link that selected nothing opens it, and a drag selects. Tab stops
on each link shown, in text order, and Enter or Space opens the one
focused. A link under the pointer or the focus draws underlined, in
link_hover_color if set. A handler that
panics is logged and disabled, and its links are plain text.
Sourcepub fn link_hover_color(self, color: impl IntoProp<Option<Color>>) -> Text
pub fn link_hover_color(self, color: impl IntoProp<Option<Color>>) -> Text
The color a link is drawn in while the pointer is over it or the
keyboard focus is on it: a color, None, or a closure returning
either. Either way the link is underlined; with None, the default,
it keeps its own color.
Sourcepub fn selectable(self, selectable: impl IntoProp<bool>) -> Text
pub fn selectable(self, selectable: impl IntoProp<bool>) -> Text
When on, the text takes the pointer with an I-beam: a press, a drag,
a double click on a word, a triple click on a line and Shift+click
select it, as in a text field, and a
press takes the keyboard focus, so Ctrl+C copies the selection.
Inside a Button, it takes the press, so the button doesn’t
click. Tab doesn’t stop on it. Off by default.
Sourcepub fn ellipsis(self, ellipsis: impl IntoProp<bool>) -> Text
pub fn ellipsis(self, ellipsis: impl IntoProp<bool>) -> Text
When on, text that doesn’t fit ends in “…” instead of being cut off.
Off by default. The same as elide with
Elide::End or Elide::None; whichever is called last wins.
Sourcepub fn elide(self, elide: impl IntoProp<Elide>) -> Text
pub fn elide(self, elide: impl IntoProp<Elide>) -> Text
Where text that doesn’t fit is cut, with “…” in its place:
Elide::None by default. With max_lines above 1, the last line
shown is cut.
Sourcepub fn max_lines(self, max_lines: impl IntoProp<u32>) -> Text
pub fn max_lines(self, max_lines: impl IntoProp<u32>) -> Text
Lets the text wrap onto at most this many lines, at word boundaries, or inside a word too long for a line. The default is 1, which never wraps. 0 counts as 1.
Sourcepub fn visible(self, visible: impl IntoProp<bool>) -> Self
pub fn visible(self, visible: impl IntoProp<bool>) -> Self
Shows or hides the widget. Hidden, it is taken out of the layout, so its space goes to the others, and it isn’t drawn, hit or reached by Tab; it drops the keyboard focus and the pointer. Its bindings and state stay, so it shows again as it was. Shown by default.
Sourcepub fn geometry(self, geometry: Signal<Rect>) -> Self
pub fn geometry(self, geometry: Signal<Rect>) -> Self
Shares where the widget is: after each layout that moves or
resizes it, its laid-out rectangle in the window’s logical
pixels, scrolled with any scroll view around it but not moved by
a style’s translate, scale or rotate, is written to geometry. A
hidden widget writes nothing. An effect that reads it may change
the layout: the window is laid out again at once, until nothing
moves.
Sourcepub fn mapped_geometry(self, geometry: Signal<Rect>) -> Self
pub fn mapped_geometry(self, geometry: Signal<Rect>) -> Self
Shares where the widget is drawn: the box around it once its own and its ancestors’ translate, scale and rotate have moved it, in the window’s logical pixels, scrolled with any scroll view around it. It is written after each layout that moves it and after each change of a transform or an offset that does, every frame of an animated one. A hidden widget writes nothing. Where the window itself is on its output is unknown: Wayland doesn’t tell a client.
Sourcepub fn accessible_name(self, name: impl IntoProp<String>) -> Self
pub fn accessible_name(self, name: impl IntoProp<String>) -> Self
What a screen reader calls the widget, instead of what it shows: a button’s text, a text’s own, or a field’s placeholder. An icon button needs one to be read at all.