Enhance Slider and VerticalSlider functionality

* Add optional default behavior
  * Add a `default` field
  * Add a `default()` method to set the `default` field
  * A double-click, ctrl-click or command-click will set the slider to the default value
* Add optional fine-grained control
  * Add an optional `step_fine` field
  * Add a `step_fine()` method to set the `step_fine` field
  * Use `step_fine` in place of `step` while shift is pressed
* Add increment/decrement via up/down keys
* Update `Slider` and `VerticalSlider` examples

Author: jpttrssn

examples/slider/src/main.rs

@@ -12,13 +12,21 @@ pub enum Message {
 
 pub struct Slider {
     slider_value: u8,
+    slider_default: u8,
+    slider_step: u8,
+    slider_step_fine: u8,
 }
 
 impl Sandbox for Slider {
     type Message = Message;
 
     fn new() -> Slider {
-        Slider { slider_value: 50 }
+        Slider {
+            slider_value: 50,
+            slider_default: 50,
+            slider_step: 5,
+            slider_step_fine: 1,
+        }
     }
 
     fn title(&self) -> String {
@@ -35,14 +43,25 @@ impl Sandbox for Slider {
 
     fn view(&self) -> Element<Message> {
         let value = self.slider_value;
+        let default = self.slider_default;
+        let step = self.slider_step;
+        let step_fine = self.slider_step_fine;
 
-        let h_slider =
-            container(slider(0..=100, value, Message::SliderChanged))
-                .width(250);
+        let h_slider = container(
+            slider(0..=100, value, Message::SliderChanged)
+                .default(default)
+                .step(step)
+                .step_fine(step_fine),
+        )
+        .width(250);
 
-        let v_slider =
-            container(vertical_slider(0..=100, value, Message::SliderChanged))
-                .height(200);
+        let v_slider = container(
+            vertical_slider(0..=100, value, Message::SliderChanged)
+                .default(default)
+                .step(step)
+                .step_fine(step_fine),
+        )
+        .height(200);
 
         let text = text(format!("{value}"));
 

widget/src/slider.rs

@@ -3,7 +3,7 @@
 //! A [`Slider`] has some local [`State`].
 use crate::core::event::{self, Event};
 use crate::core::layout;
-use crate::core::mouse;
+use crate::core::mouse::{self, click};
 use crate::core::renderer;
 use crate::core::touch;
 use crate::core::widget::tree::{self, Tree};
@@ -14,6 +14,8 @@ use crate::core::{
 
 use std::ops::RangeInclusive;
 
+use iced_renderer::core::keyboard;
+use iced_runtime::keyboard::KeyCode;
 pub use iced_style::slider::{
     Appearance, Handle, HandleShape, Rail, StyleSheet,
 };
@@ -50,7 +52,9 @@ where
 {
     range: RangeInclusive<T>,
     step: T,
+    step_fine: Option<T>,
     value: T,
+    default: Option<T>,
     on_change: Box<dyn Fn(T) -> Message + 'a>,
     on_release: Option<Message>,
     width: Length,
@@ -94,8 +98,10 @@ where
 
         Slider {
             value,
+            default: None,
             range,
             step: T::from(1),
+            step_fine: None,
             on_change: Box::new(on_change),
             on_release: None,
             width: Length::Fill,
@@ -104,6 +110,13 @@ where
         }
     }
 
+    /// Sets the optional default value for the [`Slider`].
+    /// If set, [`Slider`] will reset to this value when doubled-clicked, ctrl-clicked, or command-clicked.
+    pub fn default(mut self, default: impl Into<T>) -> Self {
+        self.default = Some(default.into());
+        self
+    }
+
     /// Sets the release message of the [`Slider`].
     /// This is called when the mouse is released from the slider.
     ///
@@ -141,6 +154,13 @@ where
         self.step = step.into();
         self
     }
+
+    /// Sets the optional fine-grained step size for the [`Slider`].
+    /// If set, this value is used as the step size while shift is pressed.
+    pub fn step_fine(mut self, step_fine: impl Into<T>) -> Self {
+        self.step_fine = Some(step_fine.into());
+        self
+    }
 }
 
 impl<'a, T, Message, Renderer> Widget<Message, Renderer>
@@ -197,8 +217,10 @@ where
             shell,
             tree.state.downcast_mut::<State>(),
             &mut self.value,
+            self.default,
             &self.range,
             self.step,
+            self.step_fine,
             self.on_change.as_ref(),
             &self.on_release,
         )
@@ -262,8 +284,10 @@ pub fn update<Message, T>(
     shell: &mut Shell<'_, Message>,
     state: &mut State,
     value: &mut T,
+    default: Option<T>,
     range: &RangeInclusive<T>,
     step: T,
+    step_fine: Option<T>,
     on_change: &dyn Fn(T) -> Message,
     on_release: &Option<Message>,
 ) -> event::Status
@@ -273,14 +297,19 @@ where
 {
     let is_dragging = state.is_dragging;
 
-    let mut change = |cursor_position: Point| {
+    let change_cursor_position = |cursor_position: Point| -> Option<T> {
         let bounds = layout.bounds();
         let new_value = if cursor_position.x <= bounds.x {
-            *range.start()
+            Some(*range.start())
         } else if cursor_position.x >= bounds.x + bounds.width {
-            *range.end()
+            Some(*range.end())
         } else {
-            let step = step.into();
+            let step = match step_fine {
+                Some(step_fine) if state.keyboard_modifiers.shift() => {
+                    step_fine.into()
+                }
+                _ => step.into(),
+            };
             let start = (*range.start()).into();
             let end = (*range.end()).into();
 
@@ -290,17 +319,67 @@ where
             let steps = (percent * (end - start) / step).round();
             let value = steps * step + start;
 
-            if let Some(value) = T::from_f64(value) {
-                value
-            } else {
-                return;
+            T::from_f64(value)
+        };
+
+        new_value
+    };
+
+    let increment = |value: T| -> Option<T> {
+        let step = match step_fine {
+            Some(step_fine) if state.keyboard_modifiers.shift() => {
+                step_fine.into()
+            }
+            _ => step.into(),
+        };
+
+        let steps = (value.into() / step).round();
+        let new_value = step * (steps + f64::from(1));
+
+        if new_value > (*range.end()).into() {
+            return Some(*range.end());
+        }
+
+        T::from_f64(new_value)
+    };
+
+    let decrement = |value: T| -> Option<T> {
+        let step = match step_fine {
+            Some(step_fine) if state.keyboard_modifiers.shift() => {
+                step_fine.into()
             }
+            _ => step.into(),
         };
 
-        if ((*value).into() - new_value.into()).abs() > f64::EPSILON {
-            shell.publish((on_change)(new_value));
+        let steps = (value.into() / step).round();
+        let new_value = step * (steps - f64::from(1));
+
+        if new_value < (*range.start()).into() {
+            return Some(*range.start());
+        }
+
+        T::from_f64(new_value)
+    };
+
+    enum Change {
+        Default,
+        CursorPosition(Point),
+        Increment,
+        Decrement,
+    }
 
-            *value = new_value;
+    let mut change = |change: Change| {
+        if let Some(new_value) = match change {
+            Change::Default => default,
+            Change::CursorPosition(point) => change_cursor_position(point),
+            Change::Increment => increment(*value),
+            Change::Decrement => decrement(*value),
+        } {
+            if ((*value).into() - new_value.into()).abs() > f64::EPSILON {
+                shell.publish((on_change)(new_value));
+
+                *value = new_value;
+            }
         }
     };
 
@@ -309,8 +388,31 @@ where
         | Event::Touch(touch::Event::FingerPressed { .. }) => {
             if let Some(cursor_position) = cursor.position_over(layout.bounds())
             {
-                change(cursor_position);
-                state.is_dragging = true;
+                let click =
+                    mouse::Click::new(cursor_position, state.last_click);
+
+                match click.kind() {
+                    click::Kind::Single => {
+                        if state.keyboard_modifiers.control()
+                            || state.keyboard_modifiers.command()
+                        {
+                            change(Change::Default);
+                            state.is_dragging = false;
+                        } else {
+                            change(Change::CursorPosition(cursor_position));
+                            state.is_dragging = true;
+                        }
+                    }
+                    click::Kind::Double => {
+                        change(Change::Default);
+                        state.is_dragging = false;
+                    }
+                    mouse::click::Kind::Triple => {
+                        state.is_dragging = false;
+                    }
+                }
+
+                state.last_click = Some(click);
 
                 return event::Status::Captured;
             }
@@ -330,11 +432,27 @@ where
         Event::Mouse(mouse::Event::CursorMoved { .. })
         | Event::Touch(touch::Event::FingerMoved { .. }) => {
             if is_dragging {
-                let _ = cursor.position().map(change);
+                let _ = cursor
+                    .position()
+                    .map(|point| change(Change::CursorPosition(point)));
 
                 return event::Status::Captured;
             }
         }
+        Event::Keyboard(keyboard::Event::KeyPressed { key_code, .. }) => {
+            if cursor.position_over(layout.bounds()).is_some() {
+                match key_code {
+                    KeyCode::Up => change(Change::Increment),
+                    KeyCode::Down => change(Change::Decrement),
+                    _ => (),
+                }
+
+                return event::Status::Captured;
+            }
+        }
+        Event::Keyboard(keyboard::Event::ModifiersChanged(modifiers)) => {
+            state.keyboard_modifiers = modifiers;
+        }
         _ => {}
     }
 
@@ -459,9 +577,11 @@ pub fn mouse_interaction(
 }
 
 /// The local state of a [`Slider`].
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+#[derive(Debug, Clone, Copy, Default)]
 pub struct State {
     is_dragging: bool,
+    last_click: Option<mouse::Click>,
+    keyboard_modifiers: keyboard::Modifiers,
 }
 
 impl State {
@@ -470,3 +590,11 @@ impl State {
         State::default()
     }
 }
+
+impl PartialEq for State {
+    fn eq(&self, other: &Self) -> bool {
+        self.is_dragging == other.is_dragging
+    }
+}
+
+impl Eq for State {}