// NOTE: Forked from scrollable.rs.
//
//! Vertically scrollable widget (containing a column of the given children)
//! that allows scrolling to the positions of its important contents, skipping
//! over sections that are less relevant.
//!
//! Scrollables let users navigate an endless amount of content with a
//! scrollbar.
//!
//! # Example
//! ```no_run
//! # mod iced { pub mod widget { pub use iced_widget::*; } }
//! # pub type Element<'a, Message> = iced_widget::core::Element<'a, Message, iced_widget::Theme, iced_widget::Renderer>;
//! use iced::widget::{column, scrollable, vertical_space};
//!
//! pub type State = scrollable::State;
//!
//! enum Message {
//! // ...
//! }
//!
//! fn view(state: &State) -> Element<'_, Message> {
//! scrollable(state, column![
//! "Scroll me!",
//! vertical_space().height(3000),
//! "You did it!",
//! ]).into()
//! }
//! ```
use std::cell::RefCell;
use std::collections::HashSet;
use iced::advanced::widget::operation::{self, Operation};
use iced::advanced::widget::tree::{self, Tree};
use iced::advanced::{
layout, renderer, widget, Clipboard, Layout, Shell, Widget,
};
use iced::border::{self, Border};
use iced::time::{Duration, Instant};
use iced::widget::container;
use iced::{
keyboard, mouse, overlay, touch, window, Background, Color, Element, Event,
Length, Padding, Pixels, Point, Rectangle, Size, Theme, Vector,
};
use iced_core::InputMethod;
use iced_runtime::Action;
use iced_utils::task::{self, Task};
pub use iced::advanced::widget::operation::scrollable::{
AbsoluteOffset, RelativeOffset,
};
/// Number of pixels of context that is skipped on normal scrolling that should
/// be made visible
const VISIBLE_CONTEXT_HEIGHT: f32 = 60.0; // roughly 3 lines of text
/// Default duration delta in milliseconds if the scroll key was not previously
/// held
const DEFAULT_DELTA: f32 = 30.0;
/// Scroll speed in pixels per second
const SPEED: f32 = 1000.0;
/// Delay before skipping between sections while a scroll key is being held
const SKIP_DELAY_MS: u64 = 400;
/// A widget that can vertically display an infinite amount of content with a
/// scrollbar.
///
/// # Example
/// ```no_run
/// # mod iced { pub mod widget { pub use iced_widget::*; } }
/// # pub type Element<'a, Message> = iced_widget::core::Element<'a, Message, iced_widget::Theme, iced_widget::Renderer>;
/// use iced::widget::{column, scrollable, vertical_space};
///
/// pub type State = scrollable::State;
///
/// enum Message {
/// // ...
/// }
///
/// fn view(state: &State) -> Element<'_, Message> {
/// scrollable(state, column![
/// "Scroll me!",
/// vertical_space().height(3000),
/// "You did it!",
/// ]).into()
/// }
/// ```
#[allow(missing_debug_implementations)]
pub struct NavScrollable<
'a,
Message,
Theme = iced::Theme,
Renderer = iced::Renderer,
> where
Theme: Catalog,
Renderer: iced::advanced::Renderer,
{
state: &'a State,
width: Length,
height: Length,
direction: Direction,
content: Element<'a, Message, Theme, Renderer>,
on_scroll: Option<Box<dyn Fn(Viewport) -> Message + 'a>>,
class: Theme::Class<'a>,
last_status: Option<Status>,
}
#[derive(Debug, Clone)]
pub struct State {
// TODO(Tomas): really, the iced `Widget::operate` has no reason not to
// take `&mut self`
inner: RefCell<StateInner>,
}
#[derive(Debug, Clone)]
pub struct StateInner {
/// Absolute horizontal offset
offset_y: f32,
/// Absolute vertical offset
offset_x: f32,
/// Id of the `NavScrollable`
id: Id,
/// Indices of sections that should be skipped on scroll
skip_sections: HashSet<usize>,
height: f32,
section_heights: Vec<f32>,
section_offsets: Vec<f32>,
needs_scrolling: bool,
skip_delay: Option<SkipDelay>,
}
pub fn needs_scrolling(state: &State) -> bool {
state.inner.borrow().needs_scrolling
}
pub fn reset_skip_delay(state: &mut State) {
state.inner.borrow_mut().skip_delay = None
}
/// Delay that occurs when a scroll key is held before skipping to a next
/// section. Every time the skip delay is checked, time `left` is updated with
/// formula `left -= now - last_update`. When `left` reaches 0 the skip is
/// performed. If the scroll button is released, the skip delay is cleared until
/// next time.
///
/// A singular key press doesn't trigger skip delay, it only happens if it was
/// preceded by a non-skip scroll first and the key is continuously held.
#[derive(Debug, Clone)]
pub struct SkipDelay {
/// Time when the last skip delay was updated.
pub last_update: Instant,
/// How much time is left before the skip can be performed
pub left: Duration,
}
fn new_skip_delay() -> SkipDelay {
let last_update = Instant::now();
let left = Duration::from_millis(SKIP_DELAY_MS);
SkipDelay { last_update, left }
}
/// Scroll down, skipping any sections that are marked to skip
pub fn scroll_down(state: &mut State, delta: Option<Duration>) {
let mut state = state.inner.borrow_mut();
let context_height = context_height(state.height);
if let Some((y, delay)) = state
.section_offsets
.iter()
.zip(&state.section_heights)
.enumerate()
.find_map(|(ix, (offset, height))| {
if !state.skip_sections.contains(&ix) {
// dbg!(ix, offset, height, nav.offset);
let bottom_frame = saturating_sub(
state.offset_y + state.height,
context_height,
);
if *offset < bottom_frame && offset + height > bottom_frame {
// The top edge of the section is visible, but the bottom
// edge of is below the bottom edge of nav, scroll down
let offset_delta = delta
.map(|delta| delta.as_millis() as f32)
.unwrap_or(DEFAULT_DELTA)
/ 1_000.0
* SPEED;
Some((state.offset_y + offset_delta, Delay::Start))
} else if *offset > bottom_frame {
// Scroll to the next section
Some((
saturating_sub(*offset, context_height),
Delay::Apply,
))
} else {
None
}
} else {
None
}
})
{
match delay {
Delay::Start => {
state.skip_delay = Some(new_skip_delay());
}
Delay::Apply => {
if let Some(SkipDelay { last_update, left }) =
state.skip_delay.as_mut()
{
let now = Instant::now();
let delta = now - *last_update;
// Check if ready to skip
if delta >= *left {
// Prepare delay for the next one
state.skip_delay = Some(new_skip_delay());
} else {
*last_update = Instant::now();
*left -= delta;
// Delay scrolling
return;
}
} else {
// Prepare delay for the next one
state.skip_delay = Some(new_skip_delay());
}
}
}
state.offset_y = y;
}
}
/// Scroll up, skipping any sections that are marked to skip
pub fn scroll_up(state: &mut State, delta: Option<Duration>) {
let mut state = state.inner.borrow_mut();
let context_height = context_height(state.height);
if let Some((y, delay)) = state
.section_offsets
.iter()
.zip(&state.section_heights)
.enumerate()
.rev()
.find_map(|(ix, (offset, height))| {
if !state.skip_sections.contains(&ix) {
// dbg!(ix, offset, height, nav.offset);
let top_frame = state.offset_y + context_height;
if offset + height > top_frame && *offset < top_frame {
// The bottom edge of the section is visible, but the top
// edge of is above the top edge of nav, scroll up
let offset_delta = delta
.map(|delta| delta.as_millis() as f32)
.unwrap_or(DEFAULT_DELTA)
/ 1_000.0
* SPEED;
Some((
saturating_sub(state.offset_y, offset_delta),
Delay::Start,
))
} else if offset + height < top_frame {
Some((
if *height
> state.height - context_height - context_height
{
// The section doesn't fit within the frame, so
// scroll to the bottom of it
saturating_sub(
offset + height + context_height,
state.height,
)
} else {
// The section fits within the frame, so scroll to
// the top of it
saturating_sub(*offset, context_height)
},
Delay::Apply,
))
} else {
None
}
} else {
None
}
})
{
match delay {
Delay::Start => {
state.skip_delay = Some(new_skip_delay());
}
Delay::Apply => {
if let Some(SkipDelay { last_update, left }) =
state.skip_delay.as_mut()
{
let now = Instant::now();
let delta = now - *last_update;
// Check if ready to skip
if delta >= *left {
// Prepare delay for the next one
state.skip_delay = Some(new_skip_delay());
} else {
*last_update = Instant::now();
*left -= delta;
// Delay scrolling
return;
}
} else {
// Prepare delay for the next one
state.skip_delay = Some(new_skip_delay());
}
}
}
state.offset_y = y;
}
}
enum Delay {
Start,
Apply,
}
/// Scroll down, skipping any sections that are marked to skip
pub fn alt_scroll_down(state: &mut State, delta: Option<Duration>) {
let offset_delta = delta
.map(|delta| delta.as_millis() as f32)
.unwrap_or(DEFAULT_DELTA)
/ 1_000.0
* SPEED;
let mut state = state.inner.borrow_mut();
let x = state.offset_x;
let y = state.offset_y + offset_delta;
state.scroll_to(AbsoluteOffset { x, y });
}
/// Scroll up, skipping any sections that are marked to skip
pub fn alt_scroll_up(state: &mut State, delta: Option<Duration>) {
let offset_delta = delta
.map(|delta| delta.as_millis() as f32)
.unwrap_or(DEFAULT_DELTA)
/ 1_000.0
* SPEED;
let mut state = state.inner.borrow_mut();
let x = state.offset_x;
let y = state.offset_y - offset_delta;
state.scroll_to(AbsoluteOffset { x, y });
}
pub fn scroll_down_to_section(state: &mut State, section_ix: usize) {
let mut state = state.inner.borrow_mut();
let context_height = context_height(state.height);
// If the given section is below the bottom frame, scroll down to align
// their bottom edges
let Some((offset, height)) = state
.section_offsets
.iter()
.zip(state.section_heights.iter())
.nth(section_ix)
else {
return;
};
if let Some(y) = {
// dbg!(ix, offset, height, nav.offset);
let bottom_frame =
saturating_sub(state.offset_y + state.height, context_height);
let top_frame = state.offset_y + context_height;
if offset + height > bottom_frame {
Some(saturating_sub(
offset + height + context_height,
state.height,
))
} else if *offset < top_frame {
Some(saturating_sub(*offset, context_height))
} else {
None
}
} {
state.offset_y = y;
}
}
pub fn scroll_up_to_section(state: &mut State, section_ix: usize) {
let mut state = state.inner.borrow_mut();
let context_height = context_height(state.height);
// If the given section is above the top frame, scroll up to align their top
// edges
let Some((offset, height)) = state
.section_offsets
.iter()
.zip(state.section_heights.iter())
.nth(section_ix)
else {
return;
};
if let Some(y) = {
// dbg!(ix, offset, height, nav.offset);
let bottom_frame =
saturating_sub(state.offset_y + state.height, context_height);
let top_frame = state.offset_y + context_height;
if *offset < top_frame {
Some(saturating_sub(*offset, context_height))
} else if offset + height > bottom_frame {
Some(saturating_sub(
offset + height + context_height,
state.height,
))
} else {
None
}
} {
state.offset_y = y;
}
}
impl<'a, Message, Theme, Renderer> NavScrollable<'a, Message, Theme, Renderer>
where
Message: 'a,
Theme: 'a + Catalog,
Renderer: 'a + iced::advanced::Renderer,
{
/// Creates a new vertical [`NavScrollable`].
pub fn new(
state: &'a State,
children: impl IntoIterator<Item = Element<'a, Message, Theme, Renderer>>,
) -> Self {
// TODO rm direction, only vertical!
Self::with_direction(state, children, Direction::default())
}
/// Creates a new [`NavScrollable`] with the given [`Direction`].
pub fn with_direction(
state: &'a State,
children: impl IntoIterator<Item = Element<'a, Message, Theme, Renderer>>,
direction: impl Into<Direction>,
) -> Self {
let iterator = children.into_iter();
let mut children = Vec::with_capacity(iterator.size_hint().0);
children.extend(iterator);
let content = iced::widget::column(children).into();
NavScrollable {
state,
width: Length::Shrink,
height: Length::Shrink,
direction: direction.into(),
content,
on_scroll: None,
class: Theme::default(),
last_status: None,
}
.validate()
}
fn validate(mut self) -> Self {
let size_hint = self.content.as_widget().size_hint();
debug_assert!(
self.direction.vertical().is_none() || !size_hint.height.is_fill(),
"scrollable content must not fill its vertical scrolling axis"
);
debug_assert!(
self.direction.horizontal().is_none() || !size_hint.width.is_fill(),
"scrollable content must not fill its horizontal scrolling axis"
);
if self.direction.horizontal().is_none() {
self.width = self.width.enclose(size_hint.width);
}
if self.direction.vertical().is_none() {
self.height = self.height.enclose(size_hint.height);
}
self
}
/// Makes the [`NavScrollable`] scroll horizontally, with default
/// [`Scrollbar`] settings.
pub fn horizontal(self) -> Self {
self.direction(Direction::Horizontal(Scrollbar::default()))
}
/// Sets the [`Direction`] of the [`NavScrollable`].
pub fn direction(mut self, direction: impl Into<Direction>) -> Self {
self.direction = direction.into();
self.validate()
}
/// Sets the width of the [`NavScrollable`].
pub fn width(mut self, width: impl Into<Length>) -> Self {
self.width = width.into();
self
}
/// Sets the height of the [`NavScrollable`].
pub fn height(mut self, height: impl Into<Length>) -> Self {
self.height = height.into();
self
}
/// Sets a function to call when the [`NavScrollable`] is scrolled.
///
/// The function takes the [`Viewport`] of the [`NavScrollable`]
pub fn on_scroll(mut self, f: impl Fn(Viewport) -> Message + 'a) -> Self {
self.on_scroll = Some(Box::new(f));
self
}
/// Anchors the vertical [`NavScrollable`] direction to the top.
pub fn anchor_top(self) -> Self {
self.anchor_y(Anchor::Start)
}
/// Anchors the vertical [`NavScrollable`] direction to the bottom.
pub fn anchor_bottom(self) -> Self {
self.anchor_y(Anchor::End)
}
/// Anchors the horizontal [`NavScrollable`] direction to the left.
pub fn anchor_left(self) -> Self {
self.anchor_x(Anchor::Start)
}
/// Anchors the horizontal [`NavScrollable`] direction to the right.
pub fn anchor_right(self) -> Self {
self.anchor_x(Anchor::End)
}
/// Sets the [`Anchor`] of the horizontal direction of the
/// [`NavScrollable`], if applicable.
pub fn anchor_x(mut self, alignment: Anchor) -> Self {
match &mut self.direction {
Direction::Horizontal(horizontal)
| Direction::Both { horizontal, .. } => {
horizontal.alignment = alignment;
}
Direction::Vertical { .. } => {}
}
self
}
/// Sets the [`Anchor`] of the vertical direction of the [`NavScrollable`],
/// if applicable.
pub fn anchor_y(mut self, alignment: Anchor) -> Self {
match &mut self.direction {
Direction::Vertical(vertical)
| Direction::Both { vertical, .. } => {
vertical.alignment = alignment;
}
Direction::Horizontal { .. } => {}
}
self
}
/// Embeds the [`Scrollbar`] into the [`NavScrollable`], instead of floating
/// on top of the content.
///
/// The `spacing` provided will be used as space between the [`Scrollbar`]
/// and the contents of the [`NavScrollable`].
pub fn spacing(mut self, new_spacing: impl Into<Pixels>) -> Self {
match &mut self.direction {
Direction::Horizontal(scrollbar)
| Direction::Vertical(scrollbar) => {
scrollbar.spacing = Some(new_spacing.into().0);
}
Direction::Both { .. } => {}
}
self
}
/// Sets the style of this [`NavScrollable`].
#[must_use]
pub fn style(mut self, style: impl Fn(&Theme, Status) -> Style + 'a) -> Self
where
Theme::Class<'a>: From<StyleFn<'a, Theme>>,
{
self.class = (Box::new(style) as StyleFn<'a, Theme>).into();
self
}
/// Sets the style class of the [`NavScrollable`].
#[must_use]
pub fn class(mut self, class: impl Into<Theme::Class<'a>>) -> Self {
self.class = class.into();
self
}
}
impl Default for State {
fn default() -> Self {
Self::new(0.0, 0.0)
}
}
impl State {
pub fn new(offset_x: f32, offset_y: f32) -> Self {
let id = Id::unique();
let inner = StateInner {
offset_y,
offset_x,
id,
skip_sections: HashSet::new(),
// The rest of these fields are set by `fn layout`
height: 0.0,
section_heights: Vec::new(),
section_offsets: Vec::new(),
needs_scrolling: false,
skip_delay: None,
};
Self {
inner: RefCell::new(inner),
}
}
pub fn with_skip_sections(self, skip_sections: HashSet<usize>) -> Self {
let Self { inner } = self;
let inner = RefCell::into_inner(inner);
let inner = StateInner {
skip_sections,
..inner
};
Self {
inner: RefCell::new(inner),
}
}
}
impl operation::Scrollable for StateInner {
fn snap_to(&mut self, _offset: RelativeOffset) {
unimplemented!("This requires relative offsets in State, which are only made absolute here")
}
fn scroll_to(&mut self, offset: AbsoluteOffset) {
StateInner::scroll_to(self, offset);
}
fn scroll_by(
&mut self,
offset: AbsoluteOffset,
bounds: Rectangle,
content_bounds: Rectangle,
) {
StateInner::scroll_by(self, offset, bounds, content_bounds);
}
}
impl StateInner {
/// Apply a scrolling offset to the current [`State`], given the bounds of
/// the [`NavScrollable`] and its contents.
pub fn scroll(
&mut self,
delta: Vector<f32>,
bounds: Rectangle,
content_bounds: Rectangle,
) {
if bounds.height < content_bounds.height {
self.offset_y = (self.offset_y + delta.y)
.clamp(0.0, content_bounds.height - bounds.height);
}
if bounds.width < content_bounds.width {
self.offset_x = (self.offset_x + delta.x)
.clamp(0.0, content_bounds.width - bounds.width);
}
}
/// Scrolls the [`NavScrollable`] to a relative amount along the y axis.
///
/// `0` represents scrollbar at the beginning, while `1` represents
/// scrollbar at the end.
pub fn scroll_y_to(
&mut self,
percentage: f32,
bounds: Rectangle,
content_bounds: Rectangle,
) {
self.offset_y = Offset::Relative(percentage.clamp(0.0, 1.0))
.absolute(bounds.y, content_bounds.y);
}
/// Scrolls the [`NavScrollable`] to a relative amount along the x axis.
///
/// `0` represents scrollbar at the beginning, while `1` represents
/// scrollbar at the end.
pub fn scroll_x_to(
&mut self,
percentage: f32,
bounds: Rectangle,
content_bounds: Rectangle,
) {
self.offset_x = Offset::Relative(percentage.clamp(0.0, 1.0))
.absolute(bounds.x, content_bounds.x);
}
/// Scroll to the provided [`AbsoluteOffset`].
pub fn scroll_to(&mut self, offset: AbsoluteOffset) {
self.offset_x = offset.x.max(0.0);
self.offset_y = offset.y.max(0.0);
}
/// Scroll by the provided [`AbsoluteOffset`].
pub fn scroll_by(
&mut self,
offset: AbsoluteOffset,
bounds: Rectangle,
content_bounds: Rectangle,
) {
self.scroll(Vector::new(offset.x, offset.y), bounds, content_bounds);
}
/// Returns the scrolling translation of the [`State`], given a
/// [`Direction`], the bounds of the [`NavScrollable`] and its contents.
fn translation(
&self,
direction: Direction,
bounds: Rectangle,
content_bounds: Rectangle,
) -> Vector {
Vector::new(
if let Some(horizontal) = direction.horizontal() {
Offset::Absolute(self.offset_x)
.translation(
bounds.width,
content_bounds.width,
horizontal.alignment,
)
.round()
} else {
0.0
},
if let Some(vertical) = direction.vertical() {
Offset::Absolute(self.offset_y)
.translation(
bounds.height,
content_bounds.height,
vertical.alignment,
)
.round()
} else {
0.0
},
)
}
}
/// The direction of [`NavScrollable`].
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Direction {
/// Vertical scrolling
Vertical(Scrollbar),
/// Horizontal scrolling
Horizontal(Scrollbar),
/// Both vertical and horizontal scrolling
Both {
/// The properties of the vertical scrollbar.
vertical: Scrollbar,
/// The properties of the horizontal scrollbar.
horizontal: Scrollbar,
},
}
impl Direction {
/// Returns the horizontal [`Scrollbar`], if any.
pub fn horizontal(&self) -> Option<&Scrollbar> {
match self {
Self::Horizontal(scrollbar) => Some(scrollbar),
Self::Both { horizontal, .. } => Some(horizontal),
Self::Vertical(_) => None,
}
}
/// Returns the vertical [`Scrollbar`], if any.
pub fn vertical(&self) -> Option<&Scrollbar> {
match self {
Self::Vertical(scrollbar) => Some(scrollbar),
Self::Both { vertical, .. } => Some(vertical),
Self::Horizontal(_) => None,
}
}
fn align(&self, delta: Vector) -> Vector {
let horizontal_alignment =
self.horizontal().map(|p| p.alignment).unwrap_or_default();
let vertical_alignment =
self.vertical().map(|p| p.alignment).unwrap_or_default();
let align = |alignment: Anchor, delta: f32| match alignment {
Anchor::Start => delta,
Anchor::End => -delta,
};
Vector::new(
align(horizontal_alignment, delta.x),
align(vertical_alignment, delta.y),
)
}
}
impl Default for Direction {
fn default() -> Self {
Self::Vertical(Scrollbar::default())
}
}
/// A scrollbar within a [`NavScrollable`].
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Scrollbar {
width: f32,
margin: f32,
scroller_width: f32,
alignment: Anchor,
spacing: Option<f32>,
}
impl Default for Scrollbar {
fn default() -> Self {
Self {
width: 10.0,
margin: 0.0,
scroller_width: 10.0,
alignment: Anchor::Start,
spacing: None,
}
}
}
impl Scrollbar {
/// Creates new [`Scrollbar`] for use in a [`NavScrollable`].
pub fn new() -> Self {
Self::default()
}
/// Sets the scrollbar width of the [`Scrollbar`] .
pub fn width(mut self, width: impl Into<Pixels>) -> Self {
self.width = width.into().0.max(0.0);
self
}
/// Sets the scrollbar margin of the [`Scrollbar`] .
pub fn margin(mut self, margin: impl Into<Pixels>) -> Self {
self.margin = margin.into().0;
self
}
/// Sets the scroller width of the [`Scrollbar`] .
pub fn scroller_width(mut self, scroller_width: impl Into<Pixels>) -> Self {
self.scroller_width = scroller_width.into().0.max(0.0);
self
}
/// Sets the [`Anchor`] of the [`Scrollbar`] .
pub fn anchor(mut self, alignment: Anchor) -> Self {
self.alignment = alignment;
self
}
/// Sets whether the [`Scrollbar`] should be embedded in the
/// [`NavScrollable`], using the given spacing between itself and the
/// contents.
///
/// An embedded [`Scrollbar`] will always be displayed, will take layout
/// space, and will not float over the contents.
pub fn spacing(mut self, spacing: impl Into<Pixels>) -> Self {
self.spacing = Some(spacing.into().0);
self
}
}
/// The anchor of the scroller of the [`NavScrollable`] relative to its
/// [`Viewport`] on a given axis.
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub enum Anchor {
/// Scroller is anchoer to the start of the [`Viewport`].
#[default]
Start,
/// Content is aligned to the end of the [`Viewport`].
End,
}
impl<Message, Theme, Renderer> Widget<Message, Theme, Renderer>
for NavScrollable<'_, Message, Theme, Renderer>
where
Theme: Catalog,
Renderer: iced::advanced::Renderer,
{
fn tag(&self) -> tree::Tag {
tree::Tag::of::<ImplicitState>()
}
fn state(&self) -> tree::State {
tree::State::new(ImplicitState::new())
}
fn children(&self) -> Vec<Tree> {
vec![Tree::new(&self.content)]
}
fn diff(&self, tree: &mut Tree) {
tree.diff_children(std::slice::from_ref(&self.content));
}
fn size(&self) -> Size<Length> {
Size {
width: self.width,
height: self.height,
}
}
fn layout(
&self,
tree: &mut Tree,
renderer: &Renderer,
limits: &layout::Limits,
) -> layout::Node {
let mut layout = |right_padding, bottom_padding| {
layout::padded(
limits,
self.width,
self.height,
Padding {
right: right_padding,
bottom: bottom_padding,
..Padding::ZERO
},
|limits| {
let child_limits = layout::Limits::new(
Size::new(limits.min().width, limits.min().height),
Size::new(
if self.direction.horizontal().is_some() {
f32::INFINITY
} else {
limits.max().width
},
if self.direction.vertical().is_some() {
f32::INFINITY
} else {
limits.max().height
},
),
);
self.content.as_widget().layout(
&mut tree.children[0],
renderer,
&child_limits,
)
},
)
};
let mut is_scrollbar_visible = false;
let layout = match self.direction {
Direction::Vertical(Scrollbar {
width,
margin,
spacing: Some(spacing),
..
})
| Direction::Horizontal(Scrollbar {
width,
margin,
spacing: Some(spacing),
..
}) => {
let is_vertical =
matches!(self.direction, Direction::Vertical(_));
let padding = width + margin * 2.0 + spacing;
let state = tree.state.downcast_mut::<ImplicitState>();
let status_quo = layout(
if is_vertical && state.is_scrollbar_visible {
padding
} else {
0.0
},
if !is_vertical && state.is_scrollbar_visible {
padding
} else {
0.0
},
);
is_scrollbar_visible = if is_vertical {
status_quo.children()[0].size().height
> status_quo.size().height
} else {
status_quo.children()[0].size().width
> status_quo.size().width
};
if state.is_scrollbar_visible == is_scrollbar_visible {
status_quo
} else {
state.is_scrollbar_visible = is_scrollbar_visible;
layout(
if is_vertical && state.is_scrollbar_visible {
padding
} else {
0.0
},
if !is_vertical && state.is_scrollbar_visible {
padding
} else {
0.0
},
)
}
}
Direction::Vertical(Scrollbar {
width,
margin,
spacing: _,
..
}) => {
let padding = width + margin * 2.0;
let state = tree.state.downcast_mut::<ImplicitState>();
let status_quo = layout(
if state.is_scrollbar_visible {
padding
} else {
0.0
},
0.0,
);
is_scrollbar_visible = status_quo.children()[0].size().height
> status_quo.size().height;
layout(
if state.is_scrollbar_visible {
padding
} else {
0.0
},
0.0,
)
}
_ => layout(0.0, 0.0),
};
// Update the `StateInner`
{
let mut state = self.state.inner.borrow_mut();
let height = layout.bounds().height;
state.height = height;
state.needs_scrolling = is_scrollbar_visible;
let sections = layout.children()[0].children();
if sections.len() == state.section_heights.len() {
state
.section_heights
.iter_mut()
.zip(sections)
.for_each(|(height, node)| *height = node.bounds().height);
let mut acc = 0.0_f32;
let StateInner {
section_heights,
section_offsets,
..
} = &mut *state;
section_offsets
.iter_mut()
.zip(section_heights.iter())
.for_each(|(offset, height)| {
// The current offset is the value of the acc
*offset = acc;
// Increment the acc with the height of this section
acc += *height;
});
} else {
let section_heights: Vec<f32> =
sections.iter().map(|node| node.bounds().height).collect();
let mut acc = 0.0_f32;
let section_offsets: Vec<f32> = section_heights
.iter()
.map(|height| {
// The current offset is the value of the acc
let offset = acc;
// Increment the acc with the height of this section
acc += *height;
offset
})
.collect();
state.section_heights = section_heights;
state.section_offsets = section_offsets;
}
}
layout
}
fn operate(
&self,
tree: &mut Tree,
layout: Layout<'_>,
renderer: &Renderer,
operation: &mut dyn Operation,
) {
let bounds = layout.bounds();
let content_layout = layout.children().next().unwrap();
let content_bounds = content_layout.bounds();
let translation = self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
);
let state = &mut *self.state.inner.borrow_mut();
let id = Some(state.id.0.clone());
operation.scrollable(
id.as_ref(),
bounds,
content_bounds,
translation,
state,
);
operation.container(id.as_ref(), bounds, &mut |operation| {
self.content.as_widget().operate(
&mut tree.children[0],
layout.children().next().unwrap(),
renderer,
operation,
);
});
}
fn update(
&mut self,
tree: &mut Tree,
event: &Event,
layout: Layout<'_>,
cursor: mouse::Cursor,
renderer: &Renderer,
clipboard: &mut dyn Clipboard,
shell: &mut Shell<'_, Message>,
_viewport: &Rectangle,
) {
let implicit_state = tree.state.downcast_mut::<ImplicitState>();
let bounds = layout.bounds();
let cursor_over_scrollable = cursor.position_over(bounds);
let content = layout.children().next().unwrap();
let content_bounds = content.bounds();
let scrollbars =
Scrollbars::new(self.state, self.direction, bounds, content_bounds);
let (mouse_over_y_scrollbar, mouse_over_x_scrollbar) =
scrollbars.is_mouse_over(cursor);
let last_offsets = {
let state = self.state.inner.borrow();
(state.offset_x, state.offset_y)
};
if let Some(last_scrolled) = implicit_state.last_scrolled {
let clear_transaction = match event {
Event::Mouse(
mouse::Event::ButtonPressed(_)
| mouse::Event::ButtonReleased(_)
| mouse::Event::CursorLeft,
) => true,
Event::Mouse(mouse::Event::CursorMoved { .. }) => {
last_scrolled.elapsed() > Duration::from_millis(100)
}
_ => last_scrolled.elapsed() > Duration::from_millis(1500),
};
if clear_transaction {
implicit_state.last_scrolled = None;
}
}
let mut update = || {
if let Some(scroller_grabbed_at) =
implicit_state.y_scroller_grabbed_at
{
match event {
Event::Mouse(mouse::Event::CursorMoved { .. })
| Event::Touch(touch::Event::FingerMoved { .. }) => {
if let Some(scrollbar) = scrollbars.y {
let Some(cursor_position) =
cursor.land().position()
else {
return;
};
self.state.inner.borrow_mut().scroll_y_to(
scrollbar.scroll_percentage_y(
scroller_grabbed_at,
cursor_position,
),
bounds,
content_bounds,
);
let _ = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
shell.capture_event();
}
}
_ => {}
}
} else if mouse_over_y_scrollbar {
match event {
Event::Mouse(mouse::Event::ButtonPressed(
mouse::Button::Left,
))
| Event::Touch(touch::Event::FingerPressed { .. }) => {
let Some(cursor_position) = cursor.position() else {
return;
};
if let (Some(scroller_grabbed_at), Some(scrollbar)) = (
scrollbars.grab_y_scroller(cursor_position),
scrollbars.y,
) {
self.state.inner.borrow_mut().scroll_y_to(
scrollbar.scroll_percentage_y(
scroller_grabbed_at,
cursor_position,
),
bounds,
content_bounds,
);
implicit_state.y_scroller_grabbed_at =
Some(scroller_grabbed_at);
let _ = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
}
shell.capture_event();
}
_ => {}
}
}
if let Some(scroller_grabbed_at) =
implicit_state.x_scroller_grabbed_at
{
match event {
Event::Mouse(mouse::Event::CursorMoved { .. })
| Event::Touch(touch::Event::FingerMoved { .. }) => {
let Some(cursor_position) = cursor.land().position()
else {
return;
};
if let Some(scrollbar) = scrollbars.x {
self.state.inner.borrow_mut().scroll_x_to(
scrollbar.scroll_percentage_x(
scroller_grabbed_at,
cursor_position,
),
bounds,
content_bounds,
);
let _ = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
}
shell.capture_event();
}
_ => {}
}
} else if mouse_over_x_scrollbar {
match event {
Event::Mouse(mouse::Event::ButtonPressed(
mouse::Button::Left,
))
| Event::Touch(touch::Event::FingerPressed { .. }) => {
let Some(cursor_position) = cursor.position() else {
return;
};
if let (Some(scroller_grabbed_at), Some(scrollbar)) = (
scrollbars.grab_x_scroller(cursor_position),
scrollbars.x,
) {
self.state.inner.borrow_mut().scroll_x_to(
scrollbar.scroll_percentage_x(
scroller_grabbed_at,
cursor_position,
),
bounds,
content_bounds,
);
implicit_state.x_scroller_grabbed_at =
Some(scroller_grabbed_at);
let _ = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
shell.capture_event();
}
}
_ => {}
}
}
if implicit_state.last_scrolled.is_none()
|| !matches!(
event,
Event::Mouse(mouse::Event::WheelScrolled { .. })
)
{
let cursor = match cursor_over_scrollable {
Some(cursor_position)
if !(mouse_over_x_scrollbar
|| mouse_over_y_scrollbar) =>
{
mouse::Cursor::Available(
cursor_position
+ self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
),
)
}
_ => mouse::Cursor::Unavailable,
};
let had_input_method = shell.input_method().is_enabled();
let translation = self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
);
self.content.as_widget_mut().update(
&mut tree.children[0],
event,
content,
cursor,
renderer,
clipboard,
shell,
&Rectangle {
y: bounds.y + translation.y,
x: bounds.x + translation.x,
..bounds
},
);
if !had_input_method
&& let InputMethod::Enabled { position, .. } =
shell.input_method_mut()
{
*position = *position - translation;
}
};
if matches!(
event,
Event::Mouse(mouse::Event::ButtonReleased(mouse::Button::Left))
| Event::Touch(
touch::Event::FingerLifted { .. }
| touch::Event::FingerLost { .. }
)
) {
implicit_state.scroll_area_touched_at = None;
implicit_state.x_scroller_grabbed_at = None;
implicit_state.y_scroller_grabbed_at = None;
return;
}
if shell.is_event_captured() {
return;
}
if let Event::Keyboard(keyboard::Event::ModifiersChanged(
modifiers,
)) = event
{
implicit_state.keyboard_modifiers = *modifiers;
return;
}
match event {
Event::Mouse(mouse::Event::WheelScrolled { delta }) => {
if cursor_over_scrollable.is_none() {
return;
}
let delta = match *delta {
mouse::ScrollDelta::Lines { x, y } => {
let is_shift_pressed =
implicit_state.keyboard_modifiers.shift();
// macOS automatically inverts the axes when Shift
// is pressed
let (x, y) = if cfg!(target_os = "macos")
&& is_shift_pressed
{
(y, x)
} else {
(x, y)
};
let movement = if !is_shift_pressed {
Vector::new(x, y)
} else {
Vector::new(y, x)
};
// TODO: Configurable speed/friction (?)
-movement * 60.0
}
mouse::ScrollDelta::Pixels { x, y } => {
-Vector::new(x, y)
}
};
self.state.inner.borrow_mut().scroll(
self.direction.align(delta),
bounds,
content_bounds,
);
let has_scrolled = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
let in_transaction = implicit_state.last_scrolled.is_some();
if has_scrolled || in_transaction {
shell.capture_event();
}
}
Event::Touch(event)
if implicit_state.scroll_area_touched_at.is_some()
|| !mouse_over_y_scrollbar
&& !mouse_over_x_scrollbar =>
{
match event {
touch::Event::FingerPressed { .. } => {
let Some(cursor_position) = cursor.position()
else {
return;
};
implicit_state.scroll_area_touched_at =
Some(cursor_position);
}
touch::Event::FingerMoved { .. } => {
if let Some(scroll_box_touched_at) =
implicit_state.scroll_area_touched_at
{
let Some(cursor_position) = cursor.position()
else {
return;
};
let delta = Vector::new(
scroll_box_touched_at.x - cursor_position.x,
scroll_box_touched_at.y - cursor_position.y,
);
self.state.inner.borrow_mut().scroll(
self.direction.align(delta),
bounds,
content_bounds,
);
implicit_state.scroll_area_touched_at =
Some(cursor_position);
// TODO: bubble up touch movements if not
// consumed.
let _ = notify_scroll(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
}
}
_ => {}
}
shell.capture_event();
}
Event::Window(window::Event::RedrawRequested(_)) => {
let _ = notify_viewport(
&mut self.state.inner.borrow_mut(),
implicit_state,
&self.on_scroll,
bounds,
content_bounds,
shell,
);
}
_ => {}
}
};
update();
let status = if implicit_state.y_scroller_grabbed_at.is_some()
|| implicit_state.x_scroller_grabbed_at.is_some()
{
Status::Dragged {
is_horizontal_scrollbar_dragged: implicit_state
.x_scroller_grabbed_at
.is_some(),
is_vertical_scrollbar_dragged: implicit_state
.y_scroller_grabbed_at
.is_some(),
is_horizontal_scrollbar_disabled: scrollbars.is_x_disabled(),
is_vertical_scrollbar_disabled: scrollbars.is_y_disabled(),
}
} else if cursor_over_scrollable.is_some() {
Status::Hovered {
is_horizontal_scrollbar_hovered: mouse_over_x_scrollbar,
is_vertical_scrollbar_hovered: mouse_over_y_scrollbar,
is_horizontal_scrollbar_disabled: scrollbars.is_x_disabled(),
is_vertical_scrollbar_disabled: scrollbars.is_y_disabled(),
}
} else {
Status::Active {
is_horizontal_scrollbar_disabled: scrollbars.is_x_disabled(),
is_vertical_scrollbar_disabled: scrollbars.is_y_disabled(),
}
};
if let Event::Window(window::Event::RedrawRequested(_now)) = event {
self.last_status = Some(status);
}
let offsets = {
let state = self.state.inner.borrow();
(state.offset_x, state.offset_y)
};
if last_offsets != offsets
|| self
.last_status
.is_some_and(|last_status| last_status != status)
{
shell.request_redraw();
}
}
fn draw(
&self,
tree: &Tree,
renderer: &mut Renderer,
theme: &Theme,
defaults: &renderer::Style,
layout: Layout<'_>,
cursor: mouse::Cursor,
viewport: &Rectangle,
) {
let bounds = layout.bounds();
let content_layout = layout.children().next().unwrap();
let content_bounds = content_layout.bounds();
let Some(visible_bounds) = bounds.intersection(viewport) else {
return;
};
let scrollbars =
Scrollbars::new(self.state, self.direction, bounds, content_bounds);
let cursor_over_scrollable = cursor.position_over(bounds);
let (mouse_over_y_scrollbar, mouse_over_x_scrollbar) =
scrollbars.is_mouse_over(cursor);
let translation = self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
);
let cursor = match cursor_over_scrollable {
Some(cursor_position)
if !(mouse_over_x_scrollbar || mouse_over_y_scrollbar) =>
{
mouse::Cursor::Available(cursor_position + translation)
}
_ => mouse::Cursor::Unavailable,
};
let style = theme.style(
&self.class,
self.last_status.unwrap_or(Status::Active {
is_horizontal_scrollbar_disabled: false,
is_vertical_scrollbar_disabled: false,
}),
);
container::draw_background(renderer, &style.container, layout.bounds());
// Draw inner content
if scrollbars.active() {
renderer.with_layer(visible_bounds, |renderer| {
renderer.with_translation(
Vector::new(-translation.x, -translation.y),
|renderer| {
self.content.as_widget().draw(
&tree.children[0],
renderer,
theme,
defaults,
content_layout,
cursor,
&Rectangle {
y: visible_bounds.y + translation.y,
x: visible_bounds.x + translation.x,
..visible_bounds
},
);
},
);
});
let draw_scrollbar =
|renderer: &mut Renderer,
style: Rail,
scrollbar: &internals::Scrollbar| {
if scrollbar.bounds.width > 0.0
&& scrollbar.bounds.height > 0.0
&& (style.background.is_some()
|| (style.border.color != Color::TRANSPARENT
&& style.border.width > 0.0))
{
renderer.fill_quad(
renderer::Quad {
bounds: scrollbar.bounds,
border: style.border,
..renderer::Quad::default()
},
style.background.unwrap_or(Background::Color(
Color::TRANSPARENT,
)),
);
}
if let Some(scroller) = scrollbar.scroller
&& scroller.bounds.width > 0.0
&& scroller.bounds.height > 0.0
&& (style.scroller.color != Color::TRANSPARENT
|| (style.scroller.border.color
!= Color::TRANSPARENT
&& style.scroller.border.width > 0.0))
{
renderer.fill_quad(
renderer::Quad {
bounds: scroller.bounds,
border: style.scroller.border,
..renderer::Quad::default()
},
style.scroller.color,
);
}
};
renderer.with_layer(
Rectangle {
width: (visible_bounds.width + 2.0).min(viewport.width),
height: (visible_bounds.height + 2.0).min(viewport.height),
..visible_bounds
},
|renderer| {
if let Some(scrollbar) = scrollbars.y {
draw_scrollbar(
renderer,
style.vertical_rail,
&scrollbar,
);
}
if let Some(scrollbar) = scrollbars.x {
draw_scrollbar(
renderer,
style.horizontal_rail,
&scrollbar,
);
}
if let (Some(x), Some(y)) = (scrollbars.x, scrollbars.y) {
let background =
style.gap.or(style.container.background);
if let Some(background) = background {
renderer.fill_quad(
renderer::Quad {
bounds: Rectangle {
x: y.bounds.x,
y: x.bounds.y,
width: y.bounds.width,
height: x.bounds.height,
},
..renderer::Quad::default()
},
background,
);
}
}
},
);
} else {
self.content.as_widget().draw(
&tree.children[0],
renderer,
theme,
defaults,
content_layout,
cursor,
&Rectangle {
x: visible_bounds.x + translation.x,
y: visible_bounds.y + translation.y,
..visible_bounds
},
);
}
}
fn mouse_interaction(
&self,
tree: &Tree,
layout: Layout<'_>,
cursor: mouse::Cursor,
_viewport: &Rectangle,
renderer: &Renderer,
) -> mouse::Interaction {
let state = tree.state.downcast_ref::<ImplicitState>();
let bounds = layout.bounds();
let cursor_over_scrollable = cursor.position_over(bounds);
let content_layout = layout.children().next().unwrap();
let content_bounds = content_layout.bounds();
let scrollbars =
Scrollbars::new(self.state, self.direction, bounds, content_bounds);
let (mouse_over_y_scrollbar, mouse_over_x_scrollbar) =
scrollbars.is_mouse_over(cursor);
if (mouse_over_x_scrollbar || mouse_over_y_scrollbar)
|| state.scrollers_grabbed()
{
mouse::Interaction::None
} else {
let translation = self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
);
let cursor = match cursor_over_scrollable {
Some(cursor_position)
if !(mouse_over_x_scrollbar || mouse_over_y_scrollbar) =>
{
mouse::Cursor::Available(cursor_position + translation)
}
_ => mouse::Cursor::Unavailable,
};
self.content.as_widget().mouse_interaction(
&tree.children[0],
content_layout,
cursor,
&Rectangle {
y: bounds.y + translation.y,
x: bounds.x + translation.x,
..bounds
},
renderer,
)
}
}
fn overlay<'b>(
&'b mut self,
tree: &'b mut Tree,
layout: Layout<'b>,
renderer: &Renderer,
viewport: &Rectangle,
translation: Vector,
) -> Option<overlay::Element<'b, Message, Theme, Renderer>> {
let bounds = layout.bounds();
let content_layout = layout.children().next().unwrap();
let content_bounds = content_layout.bounds();
let visible_bounds = bounds.intersection(viewport).unwrap_or(*viewport);
let offset = self.state.inner.borrow().translation(
self.direction,
bounds,
content_bounds,
);
self.content.as_widget_mut().overlay(
&mut tree.children[0],
layout.children().next().unwrap(),
renderer,
&visible_bounds,
translation - offset,
)
}
}
impl<'a, Message, Theme, Renderer>
From<NavScrollable<'a, Message, Theme, Renderer>>
for Element<'a, Message, Theme, Renderer>
where
Message: 'a,
Theme: 'a + Catalog,
Renderer: 'a + iced::advanced::Renderer,
{
fn from(
text_input: NavScrollable<'a, Message, Theme, Renderer>,
) -> Element<'a, Message, Theme, Renderer> {
Element::new(text_input)
}
}
/// The identifier of a [`NavScrollable`].
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct Id(widget::Id);
impl Id {
/// Creates a custom [`Id`].
pub fn new(id: impl Into<std::borrow::Cow<'static, str>>) -> Self {
Self(widget::Id::new(id))
}
/// Creates a unique [`Id`].
///
/// This function produces a different [`Id`] every time it is called.
pub fn unique() -> Self {
Self(widget::Id::unique())
}
}
impl From<Id> for widget::Id {
fn from(id: Id) -> Self {
id.0
}
}
impl From<&'static str> for Id {
fn from(id: &'static str) -> Self {
Self::new(id)
}
}
/// Produces a [`Task`] that snaps the [`NavScrollable`] with the given [`Id`]
/// to the provided [`RelativeOffset`].
pub fn snap_to<T>(id: impl Into<Id>, offset: RelativeOffset) -> Task<T> {
task::effect(Action::widget(operation::scrollable::snap_to(
id.into().0,
offset,
)))
}
/// Produces a [`Task`] that scrolls the [`NavScrollable`] with the given [`Id`]
/// to the provided [`AbsoluteOffset`].
pub fn scroll_to<T>(id: impl Into<Id>, offset: AbsoluteOffset) -> Task<T> {
task::effect(Action::widget(operation::scrollable::scroll_to(
id.into().0,
offset,
)))
}
/// Produces a [`Task`] that scrolls the [`NavScrollable`] with the given [`Id`]
/// by the provided [`AbsoluteOffset`].
pub fn scroll_by<T>(id: impl Into<Id>, offset: AbsoluteOffset) -> Task<T> {
task::effect(Action::widget(operation::scrollable::scroll_by(
id.into().0,
offset,
)))
}
fn notify_scroll<Message>(
state: &mut StateInner,
implicit_state: &mut ImplicitState,
on_scroll: &Option<Box<dyn Fn(Viewport) -> Message + '_>>,
bounds: Rectangle,
content_bounds: Rectangle,
shell: &mut Shell<'_, Message>,
) -> bool {
if notify_viewport(
state,
implicit_state,
on_scroll,
bounds,
content_bounds,
shell,
) {
implicit_state.last_scrolled = Some(Instant::now());
true
} else {
false
}
}
fn notify_viewport<Message>(
state: &mut StateInner,
implicit_state: &mut ImplicitState,
on_scroll: &Option<Box<dyn Fn(Viewport) -> Message + '_>>,
bounds: Rectangle,
content_bounds: Rectangle,
shell: &mut Shell<'_, Message>,
) -> bool {
if content_bounds.width <= bounds.width
&& content_bounds.height <= bounds.height
{
return false;
}
let viewport = Viewport {
offset_x: Offset::Absolute(state.offset_x),
offset_y: Offset::Absolute(state.offset_y),
bounds,
content_bounds,
};
// Don't publish redundant viewports to shell
if let Some(last_notified) = implicit_state.last_notified {
let last_relative_offset = last_notified.relative_offset();
let current_relative_offset = viewport.relative_offset();
let last_absolute_offset = last_notified.absolute_offset();
let current_absolute_offset = viewport.absolute_offset();
let unchanged = |a: f32, b: f32| {
(a - b).abs() <= f32::EPSILON || (a.is_nan() && b.is_nan())
};
if last_notified.bounds == bounds
&& last_notified.content_bounds == content_bounds
&& unchanged(last_relative_offset.x, current_relative_offset.x)
&& unchanged(last_relative_offset.y, current_relative_offset.y)
&& unchanged(last_absolute_offset.x, current_absolute_offset.x)
&& unchanged(last_absolute_offset.y, current_absolute_offset.y)
{
return false;
}
}
implicit_state.last_notified = Some(viewport);
if let Some(on_scroll) = on_scroll {
shell.publish(on_scroll(viewport));
}
true
}
#[derive(Debug, Clone, Copy)]
struct ImplicitState {
scroll_area_touched_at: Option<Point>,
y_scroller_grabbed_at: Option<f32>,
x_scroller_grabbed_at: Option<f32>,
keyboard_modifiers: keyboard::Modifiers,
last_notified: Option<Viewport>,
last_scrolled: Option<Instant>,
is_scrollbar_visible: bool,
}
impl Default for ImplicitState {
fn default() -> Self {
Self {
scroll_area_touched_at: None,
y_scroller_grabbed_at: None,
x_scroller_grabbed_at: None,
keyboard_modifiers: keyboard::Modifiers::default(),
last_notified: None,
last_scrolled: None,
is_scrollbar_visible: true,
}
}
}
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Offset {
Absolute(f32),
Relative(f32),
}
impl Offset {
fn absolute(self, viewport: f32, content: f32) -> f32 {
match self {
Offset::Absolute(absolute) => {
absolute.min((content - viewport).max(0.0))
}
Offset::Relative(percentage) => {
((content - viewport) * percentage).max(0.0)
}
}
}
fn translation(
self,
viewport: f32,
content: f32,
alignment: Anchor,
) -> f32 {
let offset = self.absolute(viewport, content);
match alignment {
Anchor::Start => offset,
Anchor::End => ((content - viewport).max(0.0) - offset).max(0.0),
}
}
}
/// The current [`Viewport`] of the [`NavScrollable`].
#[derive(Debug, Clone, Copy)]
pub struct Viewport {
offset_x: Offset,
offset_y: Offset,
bounds: Rectangle,
content_bounds: Rectangle,
}
impl Viewport {
/// Returns the [`AbsoluteOffset`] of the current [`Viewport`].
pub fn absolute_offset(&self) -> AbsoluteOffset {
let x = self
.offset_x
.absolute(self.bounds.width, self.content_bounds.width);
let y = self
.offset_y
.absolute(self.bounds.height, self.content_bounds.height);
AbsoluteOffset { x, y }
}
/// Returns the [`AbsoluteOffset`] of the current [`Viewport`], but with its
/// alignment reversed.
///
/// This method can be useful to switch the alignment of a [`NavScrollable`]
/// while maintaining its scrolling position.
pub fn absolute_offset_reversed(&self) -> AbsoluteOffset {
let AbsoluteOffset { x, y } = self.absolute_offset();
AbsoluteOffset {
x: (self.content_bounds.width - self.bounds.width).max(0.0) - x,
y: (self.content_bounds.height - self.bounds.height).max(0.0) - y,
}
}
/// Returns the [`RelativeOffset`] of the current [`Viewport`].
pub fn relative_offset(&self) -> RelativeOffset {
let AbsoluteOffset { x, y } = self.absolute_offset();
let x = x / (self.content_bounds.width - self.bounds.width);
let y = y / (self.content_bounds.height - self.bounds.height);
RelativeOffset { x, y }
}
/// Returns the bounds of the current [`Viewport`].
pub fn bounds(&self) -> Rectangle {
self.bounds
}
/// Returns the content bounds of the current [`Viewport`].
pub fn content_bounds(&self) -> Rectangle {
self.content_bounds
}
}
impl ImplicitState {
/// Creates a new [`State`] with the scrollbar(s) at the beginning.
pub fn new() -> Self {
ImplicitState::default()
}
/// Returns whether any scroller is currently grabbed or not.
pub fn scrollers_grabbed(&self) -> bool {
self.x_scroller_grabbed_at.is_some()
|| self.y_scroller_grabbed_at.is_some()
}
}
#[derive(Debug)]
/// State of both [`Scrollbar`]s.
struct Scrollbars {
y: Option<internals::Scrollbar>,
x: Option<internals::Scrollbar>,
}
impl Scrollbars {
/// Create y and/or x scrollbar(s) if content is overflowing the
/// [`NavScrollable`] bounds.
fn new(
state: &State,
direction: Direction,
bounds: Rectangle,
content_bounds: Rectangle,
) -> Self {
let translation =
state
.inner
.borrow()
.translation(direction, bounds, content_bounds);
let show_scrollbar_x = direction
.horizontal()
.filter(|_scrollbar| content_bounds.width > bounds.width);
let show_scrollbar_y = direction
.vertical()
.filter(|_scrollbar| content_bounds.height > bounds.height);
let y_scrollbar = if let Some(vertical) = show_scrollbar_y {
let Scrollbar {
width,
margin,
scroller_width,
..
} = *vertical;
// Adjust the height of the vertical scrollbar if the horizontal
// scrollbar is present
let x_scrollbar_height = show_scrollbar_x
.map_or(0.0, |h| h.width.max(h.scroller_width) + h.margin);
let total_scrollbar_width =
width.max(scroller_width) + 2.0 * margin;
// Total bounds of the scrollbar + margin + scroller width
let total_scrollbar_bounds = Rectangle {
x: bounds.x + bounds.width - total_scrollbar_width,
y: bounds.y,
width: total_scrollbar_width,
height: (bounds.height - x_scrollbar_height).max(0.0),
};
// Bounds of just the scrollbar
let scrollbar_bounds = Rectangle {
x: bounds.x + bounds.width
- total_scrollbar_width / 2.0
- width / 2.0,
y: bounds.y,
width,
height: (bounds.height - x_scrollbar_height).max(0.0),
};
let ratio = bounds.height / content_bounds.height;
let scroller = if ratio >= 1.0 {
None
} else {
// min height for easier grabbing with super tall content
let scroller_height =
(scrollbar_bounds.height * ratio).max(2.0);
let scroller_offset =
translation.y * ratio * scrollbar_bounds.height
/ bounds.height;
let scroller_bounds = Rectangle {
x: bounds.x + bounds.width
- total_scrollbar_width / 2.0
- scroller_width / 2.0,
y: (scrollbar_bounds.y + scroller_offset).max(0.0),
width: scroller_width,
height: scroller_height,
};
Some(internals::Scroller {
bounds: scroller_bounds,
})
};
Some(internals::Scrollbar {
total_bounds: total_scrollbar_bounds,
bounds: scrollbar_bounds,
scroller,
alignment: vertical.alignment,
disabled: content_bounds.height <= bounds.height,
})
} else {
None
};
let x_scrollbar = if let Some(horizontal) = show_scrollbar_x {
let Scrollbar {
width,
margin,
scroller_width,
..
} = *horizontal;
// Need to adjust the width of the horizontal scrollbar if the
// vertical scrollbar is present
let scrollbar_y_width = y_scrollbar
.map_or(0.0, |scrollbar| scrollbar.total_bounds.width);
let total_scrollbar_height =
width.max(scroller_width) + 2.0 * margin;
// Total bounds of the scrollbar + margin + scroller width
let total_scrollbar_bounds = Rectangle {
x: bounds.x,
y: bounds.y + bounds.height - total_scrollbar_height,
width: (bounds.width - scrollbar_y_width).max(0.0),
height: total_scrollbar_height,
};
// Bounds of just the scrollbar
let scrollbar_bounds = Rectangle {
x: bounds.x,
y: bounds.y + bounds.height
- total_scrollbar_height / 2.0
- width / 2.0,
width: (bounds.width - scrollbar_y_width).max(0.0),
height: width,
};
let ratio = bounds.width / content_bounds.width;
let scroller = if ratio >= 1.0 {
None
} else {
// min width for easier grabbing with extra wide content
let scroller_length = (scrollbar_bounds.width * ratio).max(2.0);
let scroller_offset =
translation.x * ratio * scrollbar_bounds.width
/ bounds.width;
let scroller_bounds = Rectangle {
x: (scrollbar_bounds.x + scroller_offset).max(0.0),
y: bounds.y + bounds.height
- total_scrollbar_height / 2.0
- scroller_width / 2.0,
width: scroller_length,
height: scroller_width,
};
Some(internals::Scroller {
bounds: scroller_bounds,
})
};
Some(internals::Scrollbar {
total_bounds: total_scrollbar_bounds,
bounds: scrollbar_bounds,
scroller,
alignment: horizontal.alignment,
disabled: content_bounds.width <= bounds.width,
})
} else {
None
};
Self {
y: y_scrollbar,
x: x_scrollbar,
}
}
fn is_mouse_over(&self, cursor: mouse::Cursor) -> (bool, bool) {
if let Some(cursor_position) = cursor.position() {
(
self.y
.as_ref()
.map(|scrollbar| scrollbar.is_mouse_over(cursor_position))
.unwrap_or(false),
self.x
.as_ref()
.map(|scrollbar| scrollbar.is_mouse_over(cursor_position))
.unwrap_or(false),
)
} else {
(false, false)
}
}
fn is_y_disabled(&self) -> bool {
self.y.map(|y| y.disabled).unwrap_or(false)
}
fn is_x_disabled(&self) -> bool {
self.x.map(|x| x.disabled).unwrap_or(false)
}
fn grab_y_scroller(&self, cursor_position: Point) -> Option<f32> {
let scrollbar = self.y?;
let scroller = scrollbar.scroller?;
if scrollbar.total_bounds.contains(cursor_position) {
Some(if scroller.bounds.contains(cursor_position) {
(cursor_position.y - scroller.bounds.y) / scroller.bounds.height
} else {
0.5
})
} else {
None
}
}
fn grab_x_scroller(&self, cursor_position: Point) -> Option<f32> {
let scrollbar = self.x?;
let scroller = scrollbar.scroller?;
if scrollbar.total_bounds.contains(cursor_position) {
Some(if scroller.bounds.contains(cursor_position) {
(cursor_position.x - scroller.bounds.x) / scroller.bounds.width
} else {
0.5
})
} else {
None
}
}
fn active(&self) -> bool {
self.y.is_some() || self.x.is_some()
}
}
pub(super) mod internals {
use iced_core::{Point, Rectangle};
use super::Anchor;
#[derive(Debug, Copy, Clone)]
pub struct Scrollbar {
pub total_bounds: Rectangle,
pub bounds: Rectangle,
pub scroller: Option<Scroller>,
pub alignment: Anchor,
pub disabled: bool,
}
impl Scrollbar {
/// Returns whether the mouse is over the scrollbar or not.
pub fn is_mouse_over(&self, cursor_position: Point) -> bool {
self.total_bounds.contains(cursor_position)
}
/// Returns the y-axis scrolled percentage from the cursor position.
pub fn scroll_percentage_y(
&self,
grabbed_at: f32,
cursor_position: Point,
) -> f32 {
if let Some(scroller) = self.scroller {
let percentage = (cursor_position.y
- self.bounds.y
- scroller.bounds.height * grabbed_at)
/ (self.bounds.height - scroller.bounds.height);
match self.alignment {
Anchor::Start => percentage,
Anchor::End => 1.0 - percentage,
}
} else {
0.0
}
}
/// Returns the x-axis scrolled percentage from the cursor position.
pub fn scroll_percentage_x(
&self,
grabbed_at: f32,
cursor_position: Point,
) -> f32 {
if let Some(scroller) = self.scroller {
let percentage = (cursor_position.x
- self.bounds.x
- scroller.bounds.width * grabbed_at)
/ (self.bounds.width - scroller.bounds.width);
match self.alignment {
Anchor::Start => percentage,
Anchor::End => 1.0 - percentage,
}
} else {
0.0
}
}
}
/// The handle of a [`Scrollbar`].
#[derive(Debug, Clone, Copy)]
pub struct Scroller {
/// The bounds of the [`Scroller`].
pub bounds: Rectangle,
}
}
/// The possible status of a [`NavScrollable`].
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Status {
/// The [`NavScrollable`] can be interacted with.
Active {
/// Whether or not the horizontal scrollbar is disabled meaning the
/// content isn't overflowing.
is_horizontal_scrollbar_disabled: bool,
/// Whether or not the vertical scrollbar is disabled meaning the
/// content isn't overflowing.
is_vertical_scrollbar_disabled: bool,
},
/// The [`NavScrollable`] is being hovered.
Hovered {
/// Indicates if the horizontal scrollbar is being hovered.
is_horizontal_scrollbar_hovered: bool,
/// Indicates if the vertical scrollbar is being hovered.
is_vertical_scrollbar_hovered: bool,
/// Whether or not the horizontal scrollbar is disabled meaning the
/// content isn't overflowing.
is_horizontal_scrollbar_disabled: bool,
/// Whether or not the vertical scrollbar is disabled meaning the
/// content isn't overflowing.
is_vertical_scrollbar_disabled: bool,
},
/// The [`NavScrollable`] is being dragged.
Dragged {
/// Indicates if the horizontal scrollbar is being dragged.
is_horizontal_scrollbar_dragged: bool,
/// Indicates if the vertical scrollbar is being dragged.
is_vertical_scrollbar_dragged: bool,
/// Whether or not the horizontal scrollbar is disabled meaning the
/// content isn't overflowing.
is_horizontal_scrollbar_disabled: bool,
/// Whether or not the vertical scrollbar is disabled meaning the
/// content isn't overflowing.
is_vertical_scrollbar_disabled: bool,
},
}
/// The appearance of a scrollable.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Style {
/// The [`container::Style`] of a scrollable.
pub container: container::Style,
/// The vertical [`Rail`] appearance.
pub vertical_rail: Rail,
/// The horizontal [`Rail`] appearance.
pub horizontal_rail: Rail,
/// The [`Background`] of the gap between a horizontal and vertical
/// scrollbar.
pub gap: Option<Background>,
}
/// The appearance of the scrollbar of a scrollable.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Rail {
/// The [`Background`] of a scrollbar.
pub background: Option<Background>,
/// The [`Border`] of a scrollbar.
pub border: Border,
/// The appearance of the [`Scroller`] of a scrollbar.
pub scroller: Scroller,
}
/// The appearance of the scroller of a scrollable.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Scroller {
/// The [`Color`] of the scroller.
pub color: Color,
/// The [`Border`] of the scroller.
pub border: Border,
}
/// The theme catalog of a [`NavScrollable`].
pub trait Catalog {
/// The item class of the [`Catalog`].
type Class<'a>;
/// The default class produced by the [`Catalog`].
fn default<'a>() -> Self::Class<'a>;
/// The [`Style`] of a class with the given status.
fn style(&self, class: &Self::Class<'_>, status: Status) -> Style;
}
/// A styling function for a [`NavScrollable`].
pub type StyleFn<'a, Theme> = Box<dyn Fn(&Theme, Status) -> Style + 'a>;
impl Catalog for Theme {
type Class<'a> = StyleFn<'a, Self>;
fn default<'a>() -> Self::Class<'a> {
Box::new(default)
}
fn style(&self, class: &Self::Class<'_>, status: Status) -> Style {
class(self, status)
}
}
/// The default style of a [`NavScrollable`].
pub fn default(theme: &Theme, status: Status) -> Style {
let palette = theme.extended_palette();
let scrollbar = Rail {
background: Some(palette.background.weak.color.into()),
border: border::rounded(2),
scroller: Scroller {
color: palette.background.strong.color,
border: border::rounded(2),
},
};
match status {
Status::Active { .. } => Style {
container: container::Style::default(),
vertical_rail: scrollbar,
horizontal_rail: scrollbar,
gap: None,
},
Status::Hovered {
is_horizontal_scrollbar_hovered,
is_vertical_scrollbar_hovered,
..
} => {
let hovered_scrollbar = Rail {
scroller: Scroller {
color: palette.primary.strong.color,
..scrollbar.scroller
},
..scrollbar
};
Style {
container: container::Style::default(),
vertical_rail: if is_vertical_scrollbar_hovered {
hovered_scrollbar
} else {
scrollbar
},
horizontal_rail: if is_horizontal_scrollbar_hovered {
hovered_scrollbar
} else {
scrollbar
},
gap: None,
}
}
Status::Dragged {
is_horizontal_scrollbar_dragged,
is_vertical_scrollbar_dragged,
..
} => {
let dragged_scrollbar = Rail {
scroller: Scroller {
color: palette.primary.base.color,
..scrollbar.scroller
},
..scrollbar
};
Style {
container: container::Style::default(),
vertical_rail: if is_vertical_scrollbar_dragged {
dragged_scrollbar
} else {
scrollbar
},
horizontal_rail: if is_horizontal_scrollbar_dragged {
dragged_scrollbar
} else {
scrollbar
},
gap: None,
}
}
}
}
fn saturating_sub(left: f32, right: f32) -> f32 {
if left > right {
left - right
} else {
0.0
}
}
// Don't show context when the nav is too small.
fn context_height(nav_height: f32) -> f32 {
if nav_height < VISIBLE_CONTEXT_HEIGHT + VISIBLE_CONTEXT_HEIGHT {
0.0
} else {
VISIBLE_CONTEXT_HEIGHT
}
}