Struct RadioGroup 

pub struct RadioGroup<Msg> { /* private fields */ }

A set of options of which exactly one is chosen, for a few choices that should all stay visible. For many choices use a Select.

The group takes focus as one control: arrow keys choose the previous or next option, Home and End the first and last, and a click anywhere on an option, mark or label, chooses it. By default (RadioStyle::Square) every option shows a small square centred in two cells and the chosen one differs by colour: choosing blends the new square towards the chosen tone over two motion.steps while the old one blends back. RadioStyle::Mark also grows the chosen square into a full two-cell box, swapping shape halfway through the same blend. With reduced motion the change is immediate. RadioStyle::Box gives every option the checkbox’s box and RadioStyle::Dot a dot or a ring. Nothing is bracketed, and every style keeps two cells (one for dots) in every state, so labels never move. The application owns the choice.

The box style looks exactly like a checkbox: what differs is the meaning. A radio group chooses one option and a checkbox turns each option on or off by itself.

Style keys: radio.mark (fg, also the colour of the full box) for marks, whose blank icons take their tones from radio.box (bg); radio.box (bg) for boxes; radio (fg) for dots; radio-label (fg, bold); all with states hover, focus, checked, disabled. Icons: radio-mark-small for marks, dot and dot-outline for dots.

Implementations

impl<Msg> RadioGroup<Msg>

pub fn new(options: impl IntoIterator<Item = impl Into<String>>) -> Self

A vertical group of options with nothing chosen.

pub fn selected(self, index: Option<usize>) -> Self

The chosen option.

pub fn horizontal(self, horizontal: bool) -> Self

Lays the options out in one row instead of one per line.

pub fn style(self, style: RadioStyle) -> Self

Chooses how options are marked.

pub fn disabled(self, disabled: bool) -> Self

Greys the group out; it cannot be focused or changed.

pub fn on_select(self, message: impl Fn(usize) -> Msg + 'static) -> Self

Message for choosing option index.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for RadioGroup<Msg>

fn measure(&self, _cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn event(&self, cx: &mut EventCx<'_, Msg>, event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.

fn paint_overlay(&self, _cx: &mut PaintCx<'_>, _anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.