cranpose_ui/modifier/
toggleable.rs

1use std::rc::Rc;
2
3use cranpose_foundation::SemanticsWidgetRole;
4
5use super::{Modifier, SemanticsConfiguration, inspector_metadata};
6
7impl Modifier {
8    /// Make the component a two-state control.
9    ///
10    /// This is Compose's `Modifier.toggleable(value, enabled, role,
11    /// onValueChange)`: a click hands the callback the **new** value, so a
12    /// caller writes `.toggleable(checked, None, None, move |next|
13    /// state.set(next))` and never has to read the old one back out of its own
14    /// state to invert it.
15    ///
16    /// `role` is what a screen reader announces the control **as** — "switch",
17    /// "checkbox" — before it is acted on, and it is genuinely optional: a
18    /// toggleable row could be either, so Compose's parameter defaults to
19    /// `null` and so does passing `None` here. Wear's own `SwitchButton` leaves
20    /// it unset on the row and puts `Role.Switch` on the `Switch` control
21    /// inside, which merges up into the same node; naming it on the row reaches
22    /// the same announcement without leaning on a merge rule.
23    ///
24    /// A toggleable control with no role is not silent — the description and
25    /// the state below still speak — but it is announced as an unnamed
26    /// something the reader cannot say is toggleable, which is the whole of the
27    /// difference.
28    ///
29    /// The **state** it publishes regardless: `toggled`, Compose's
30    /// `toggleableState`, so a reader landing on the row says whether it is on
31    /// without the caller spelling it into the description. `description` stays
32    /// because a row still needs a name, and a caller that wants the state
33    /// spoken a particular way ("Haptics, on") can still say it there.
34    pub fn toggleable(
35        self,
36        value: bool,
37        description: Option<String>,
38        role: Option<SemanticsWidgetRole>,
39        on_value_change: impl Fn(bool) + 'static,
40    ) -> Self {
41        let on_value_change = Rc::new(on_value_change);
42        let toggled = value;
43        let modifier = Modifier::empty()
44            .clickable(move |_point| on_value_change(!toggled))
45            .with_inspector_metadata(inspector_metadata("toggleable", move |info| {
46                info.add_property("value", if toggled { "true" } else { "false" });
47                info.add_property("onValueChange", "provided");
48            }))
49            .then(
50                Modifier::empty().semantics(move |config: &mut SemanticsConfiguration| {
51                    config.is_clickable = true;
52                    config.toggled = Some(toggled);
53                    if let Some(description) = &description {
54                        config.content_description = Some(description.clone());
55                    }
56                    if let Some(role) = role {
57                        config.role = Some(role);
58                    }
59                }),
60            );
61        self.then(modifier)
62    }
63}
64
65#[cfg(test)]
66#[path = "tests/toggleable_tests.rs"]
67mod tests;
cranpose_ui/modifier/toggleable.rs

cranpose_ui/modifier/
toggleable.rs
