Skip to main content

uzor_framework/widgets/
button.rs

1//! Button: one call registers the hit rect and paints it.
2
3use uzor::render::RenderContext;
4use uzor::ui::widgets::atomic::button::{
5    draw_button, register_input_coordinator_button, ButtonSettings, ButtonState, ButtonView,
6    DefaultButtonStyle,
7};
8use uzor::Rect;
9use uzor::WidgetId;
10
11use crate::handle::{VisualView, Widgets};
12use crate::types::spec::Spec;
13
14use super::host::ContentCx;
15use super::paint::{interaction_state, parts, token_theme};
16
17/// Register and draw a button.
18///
19/// This is the one-call convenience the deleted level-2
20/// `the old L2 register helper` used to be, over [`Widgets`] instead of
21/// `app context` (design §6.4). Hover and press come from `cx`'s
22/// [`VisualView`]; `view.disabled` forces the disabled colours. A click is
23/// not consumed here — the app reads [`VisualView::clicked`].
24pub fn button<'a, C: ContentCx<'a>>(
25    cx: &mut C,
26    id: impl Into<WidgetId>,
27    rect: Rect,
28    view: &ButtonView<'_>,
29    settings: &ButtonSettings,
30) {
31    let id = id.into();
32    cx.with_paint(|render, widgets, visual, _tokens| {
33        paint_button(render, widgets, visual, id, rect, view, settings);
34    });
35}
36
37pub(crate) fn paint_button<S: Spec>(
38    render: &mut dyn RenderContext,
39    widgets: &mut Widgets<'_>,
40    visual: &VisualView<S>,
41    id: WidgetId,
42    rect: Rect,
43    view: &ButtonView<'_>,
44    settings: &ButtonSettings,
45) {
46    let ws = interaction_state(visual, &id, view.disabled);
47    let (coord, states, layer) = parts(widgets);
48    let state = states.get_or_insert_with(id.clone(), ButtonState::default);
49    register_input_coordinator_button(coord, id, rect, layer, state);
50    draw_button(render, rect, ws, view, settings, |_, _, _, _| {});
51}
52
53/// Settings whose theme is `tokens` and whose geometry is the library default.
54pub(crate) fn button_settings(tokens: &uzor::tokens::Tokens) -> ButtonSettings {
55    ButtonSettings {
56        theme: Box::new(token_theme(tokens)),
57        style: Box::new(DefaultButtonStyle),
58    }
59}