omp-tui 0.1.0

Retained-mode terminal UI components, rendering, input, and terminal integration for omp
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use omp_core::Str;

use crate::{
	component::{Component, PaintCtx, Slot, next_slot},
	frame::Rect,
	props::{Prop, PropValue, Props},
	rich::cell_width,
};

/// A theme-resolved glyph backing the `<icon>` markup tag.
pub struct Icon {
	props: Props,
	slot:  Slot,
	name:  Str,
}

impl Icon {
	/// Creates an icon with no assigned name.
	pub fn new() -> Self {
		Self { props: Props::new(), slot: next_slot(), name: Str::default() }
	}

	/// Creates an icon with the requested theme glyph name.
	pub fn named(name: impl Into<Str>) -> Self {
		Self { name: name.into(), ..Self::new() }
	}

	/// Sets one icon property.
	pub fn with(mut self, prop: Prop, value: impl Into<PropValue>) -> Self {
		self.props.set(prop, value);
		self
	}

	/// Sets one icon property from a string.
	pub fn with_str(self, prop: Prop, value: &str) -> Self {
		self.with(prop, value)
	}

	fn glyph<'a>(&'a self, ctx: &'a crate::UiContext) -> &'a str {
		ctx.charset.icon_named(&self.name).unwrap_or(&self.name)
	}
}

impl Default for Icon {
	fn default() -> Self {
		Self::new()
	}
}

impl Component for Icon {
	fn props(&self) -> &Props {
		&self.props
	}

	fn props_mut(&mut self) -> &mut Props {
		&mut self.props
	}

	fn slot(&self) -> Slot {
		self.slot
	}

	fn measure(&mut self, ctx: &crate::UiContext) -> (u16, u16) {
		let width = cell_width(self.glyph(ctx));
		(width, width)
	}

	fn height(&mut self, _ctx: &crate::UiContext, _width: u16) -> u16 {
		1
	}

	fn paint(&mut self, pc: &mut PaintCtx<'_>, rect: Rect) {
		if rect.y >= pc.clip || rect.width == 0 || rect.height == 0 {
			return;
		}
		let glyph = self.glyph(pc.ctx);
		let style = self.props.style(&pc.ctx.theme);
		let room = rect.width;
		if cell_width(glyph) <= room {
			pc.frame.put(rect.x, rect.y, glyph, style);
		}
	}
}