Struct Carousel

pub struct Carousel<Msg: Clone> {
    pub children: Vec<Element<Msg>>,
    pub id: Option<WidgetId>,
    pub focused_width_frac: f32,
    pub gap: f32,
    pub offset: f32,
}

Fields

children: Vec<Element<Msg>>

Child widgets in display order, left-to-right.

id: Option<WidgetId>

Optional stable identifier — used by the host as the key for its drag / inertia / snap state.

focused_width_frac: f32

Each child’s width as a fraction of the viewport width. 0.8 leaves 10% on each side for the neighbours to peek out.

gap: f32

Horizontal gap between adjacent children, in logical pixels.

offset: f32

Logical-pixel offset applied to every child. Positive values shift children to the right (revealing later tiles). The host clamps, snaps and animates this value.

Implementations

impl<Msg: Clone> Carousel<Msg>

pub fn push(self, child: impl Into<Element<Msg>>) -> Self

pub fn id(self, id: WidgetId) -> Self

pub fn focused_width_frac(self, f: f32) -> Self

pub fn gap(self, g: f32) -> Self

pub fn offset(self, o: f32) -> Self

pub fn preferred_size(&self, max_width: f32, canvas: &Canvas) -> (f32, f32)

pub fn snap_offset(&self, viewport_w: f32, idx: usize) -> f32

Snap-target offset that centres idx in the viewport. Positive values shift the carousel content right — i.e. the negation of the natural “scroll x” so callers can pass it straight back into offset().

pub fn focused_index(&self, viewport_w: f32) -> usize

Index of the child whose centre is closest to the viewport centre, given the current offset. Used by the host to decide which tile a release should snap to and to compute the keyboard-navigation target.

pub fn layout(&self, rect: Rect, _canvas: &Canvas) -> Vec<(Rect, usize)>

pub fn draw(&self)

Trait Implementations

impl<Msg: Clone + 'static> From<Carousel<Msg>> for Element<Msg>

fn from(c: Carousel<Msg>) -> Self

Converts to this type from the input type.