Struct Scrollable

pub struct Scrollable<'a, Message, Theme = Theme, Renderer = Renderer>
where
    Theme: Catalog,
    Renderer: Renderer,
{ /* private fields */ }

A widget that can vertically display an infinite amount of content with a scrollbar.

Example

use iced::widget::{column, scrollable, space};

enum Message {
    // ...
}

fn view(state: &State) -> Element<'_, Message> {
    scrollable(column![
        "Scroll me!",
        space().height(3000),
        "You did it!",
    ]).into()
}

Implementations

impl<'a, Message, Theme, Renderer> Scrollable<'a, Message, Theme, Renderer>

where Theme: Catalog, Renderer: Renderer,

pub fn new( content: impl Into<Element<'a, Message, Theme, Renderer>>, ) -> Scrollable<'a, Message, Theme, Renderer>

Creates a new vertical Scrollable.

pub fn with_direction( content: impl Into<Element<'a, Message, Theme, Renderer>>, direction: impl Into<Direction>, ) -> Scrollable<'a, Message, Theme, Renderer>

Creates a new Scrollable with the given Direction.

pub fn horizontal(self) -> Scrollable<'a, Message, Theme, Renderer>

Makes the Scrollable scroll horizontally, with default Scrollbar settings.

pub fn direction( self, direction: impl Into<Direction>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the Direction of the Scrollable.

pub fn id(self, id: impl Into<Id>) -> Scrollable<'a, Message, Theme, Renderer>

Sets the [widget::Id] of the Scrollable.

pub fn width( self, width: impl Into<Length>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the width of the Scrollable.

pub fn height( self, height: impl Into<Length>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the height of the Scrollable.

pub fn on_scroll( self, f: impl Fn(Viewport) -> Message + 'a, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets a function to call when the Scrollable is scrolled.

The function takes the Viewport of the Scrollable

pub fn anchor_top(self) -> Scrollable<'a, Message, Theme, Renderer>

Anchors the vertical Scrollable direction to the top.

pub fn anchor_bottom(self) -> Scrollable<'a, Message, Theme, Renderer>

Anchors the vertical Scrollable direction to the bottom.

pub fn anchor_left(self) -> Scrollable<'a, Message, Theme, Renderer>

Anchors the horizontal Scrollable direction to the left.

pub fn anchor_right(self) -> Scrollable<'a, Message, Theme, Renderer>

Anchors the horizontal Scrollable direction to the right.

pub fn anchor_x( self, alignment: Anchor, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the Anchor of the horizontal direction of the Scrollable, if applicable.

pub fn anchor_y( self, alignment: Anchor, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the Anchor of the vertical direction of the Scrollable, if applicable.

pub fn spacing( self, new_spacing: impl Into<Pixels>, ) -> Scrollable<'a, Message, Theme, Renderer>

Embeds the Scrollbar into the Scrollable, instead of floating on top of the content.

The spacing provided will be used as space between the Scrollbar and the contents of the Scrollable.

pub fn auto_scroll( self, auto_scroll: bool, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets whether the user should be allowed to auto-scroll the Scrollable with the middle mouse button.

By default, it is disabled.

pub fn scrollbar_width( self, width: impl Into<Pixels>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the scrollbar width of the Scrollbar.

pub fn scroller_width( self, width: impl Into<Pixels>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the scroller width of the Scrollbar.

pub fn scrollbar_padding( self, padding: impl Into<Pixels>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the padding at the start and end of the Scrollbar.

pub fn style( self, style: impl Fn(&Theme, Status) -> Style + 'a, ) -> Scrollable<'a, Message, Theme, Renderer>

where <Theme as Catalog>::Class<'a>: From<Box<dyn Fn(&Theme, Status) -> Style + 'a>>,

Sets the style of this Scrollable.

pub fn class( self, class: impl Into<<Theme as Catalog>::Class<'a>>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the style class of the Scrollable.

pub fn name( self, name: impl Into<Cow<'a, str>>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the name of the Scrollable.

pub fn description_widget( self, description: &impl Describes, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the description of the Scrollable.

pub fn description( self, description: impl Into<Cow<'a, str>>, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the description of the Scrollable.

pub fn label( self, label: &dyn Labels, ) -> Scrollable<'a, Message, Theme, Renderer>

Sets the label of the Scrollable.

Trait Implementations

impl<'a, Message, Theme, Renderer> From<Scrollable<'a, Message, Theme, Renderer>> for Element<'a, Message, Theme, Renderer>

where Message: 'a, Theme: 'a + Catalog, Renderer: 'a + Renderer,

fn from( text_input: Scrollable<'a, Message, Theme, Renderer>, ) -> Element<'a, Message, Theme, Renderer>

Converts to this type from the input type.

impl<Message, Theme, Renderer> Widget<Message, Theme, Renderer> for Scrollable<'_, Message, Theme, Renderer>

where Theme: Catalog, Renderer: Renderer,

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&mut self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn operate( &mut self, tree: &mut Tree, layout: Layout<'_>, renderer: &Renderer, operation: &mut dyn Operation, )

Applies an Operation to the Widget.

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, renderer: &Renderer, clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, _viewport: &Rectangle, )

Processes a runtime Event.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, defaults: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor: Cursor, _viewport: &Rectangle, renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn overlay<'b>( &'b mut self, tree: &'b mut Tree, layout: Layout<'b>, renderer: &Renderer, viewport: &Rectangle, translation: Vector, ) -> Option<Element<'b, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn a11y_nodes( &self, layout: Layout<'_>, state: &Tree, cursor: Cursor, ) -> A11yTree

get the a11y nodes for the widget and its children

fn id(&self) -> Option<Id>

Returns the id of the widget

fn set_id(&mut self, id: Id)

Sets the id of the widget This may be called while diffing the widget tree

fn drag_destinations( &self, tree: &Tree, layout: Layout<'_>, renderer: &Renderer, dnd_rectangles: &mut DndDestinationRectangles, )

Adds the drag destination rectangles of the widget. Runs after the layout phase for each widget in the tree.

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.