From ba95042fff378213f5029b2b164d79e768482a47 Mon Sep 17 00:00:00 2001
From: Casper Storm <casper.storm@lich.io>
Date: Mon, 12 Dec 2022 15:27:00 +0100
Subject: [PATCH 1/3] Vertical orientation added to Slider.

---
 Cargo.toml                  |   1 +
 examples/slider/Cargo.toml  |   9 ++
 examples/slider/README.md   |  14 +++
 examples/slider/sliders.gif | Bin 0 -> 87275 bytes
 examples/slider/src/main.rs |  69 +++++++++++++
 native/src/widget/slider.rs | 199 ++++++++++++++++++++++++++++--------
 6 files changed, 251 insertions(+), 41 deletions(-)
 create mode 100644 examples/slider/Cargo.toml
 create mode 100644 examples/slider/README.md
 create mode 100644 examples/slider/sliders.gif
 create mode 100644 examples/slider/src/main.rs

diff --git a/Cargo.toml b/Cargo.toml
index 9c6a435a99..e0eec17f4d 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -90,6 +90,7 @@ members = [
     "examples/tour",
     "examples/url_handler",
     "examples/websocket",
+    "examples/slider",
 ]
 
 [dependencies]
diff --git a/examples/slider/Cargo.toml b/examples/slider/Cargo.toml
new file mode 100644
index 0000000000..112d7cff5e
--- /dev/null
+++ b/examples/slider/Cargo.toml
@@ -0,0 +1,9 @@
+[package]
+name = "slider"
+version = "0.1.0"
+authors = ["Casper Rogild Storm<casper@rogildstorm.com>"]
+edition = "2021"
+publish = false
+
+[dependencies]
+iced = { path = "../.." }
diff --git a/examples/slider/README.md b/examples/slider/README.md
new file mode 100644
index 0000000000..0d409dc687
--- /dev/null
+++ b/examples/slider/README.md
@@ -0,0 +1,14 @@
+## Slider
+
+A bar and a handle that selects a single value from a range of values.  
+Can be oriented both vertical and horizontal.
+
+<div align="center">
+    <img src="sliders.gif">
+</div>
+
+You can run it with `cargo run`:
+
+```
+cargo run --package slider
+```
diff --git a/examples/slider/sliders.gif b/examples/slider/sliders.gif
new file mode 100644
index 0000000000000000000000000000000000000000..f906d05ab1a6a43705e4a6911804fdbea3e0ca8a
GIT binary patch
literal 87275
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

literal 0
HcmV?d00001

diff --git a/examples/slider/src/main.rs b/examples/slider/src/main.rs
new file mode 100644
index 0000000000..4477038209
--- /dev/null
+++ b/examples/slider/src/main.rs
@@ -0,0 +1,69 @@
+use iced::widget::{column, container, slider, text};
+use iced::{Element, Length, Sandbox, Settings};
+
+pub fn main() -> iced::Result {
+    Slider::run(Settings::default())
+}
+
+#[derive(Debug, Clone)]
+pub enum Message {
+    SliderChanged(u8),
+}
+
+pub struct Slider {
+    slider_value: u8,
+}
+
+impl Sandbox for Slider {
+    type Message = Message;
+
+    fn new() -> Slider {
+        Slider { slider_value: 50 }
+    }
+
+    fn title(&self) -> String {
+        String::from("Slider - Iced")
+    }
+
+    fn update(&mut self, message: Message) {
+        match message {
+            Message::SliderChanged(value) => {
+                self.slider_value = value;
+            }
+        }
+    }
+
+    fn view(&self) -> Element<Message> {
+        use slider::Orientation::{Horizontal, Vertical};
+
+        let value = self.slider_value;
+
+        let h_slider = container(
+            slider(0..=100, value, Message::SliderChanged)
+                .orientation(Horizontal),
+        )
+        .width(Length::Units(250));
+
+        let v_slider = container(
+            slider(0..=100, value, Message::SliderChanged)
+                .orientation(Vertical),
+        )
+        .height(Length::Units(200));
+
+        let text = text(format!("{value}"));
+
+        container(
+            column![
+                container(v_slider).width(Length::Fill).center_x(),
+                container(h_slider).width(Length::Fill).center_x(),
+                container(text).width(Length::Fill).center_x(),
+            ]
+            .spacing(25),
+        )
+        .height(Length::Fill)
+        .width(Length::Fill)
+        .center_x()
+        .center_y()
+        .into()
+    }
+}
diff --git a/native/src/widget/slider.rs b/native/src/widget/slider.rs
index 585d9c35c9..33d8701406 100644
--- a/native/src/widget/slider.rs
+++ b/native/src/widget/slider.rs
@@ -16,10 +16,9 @@ use std::ops::RangeInclusive;
 
 pub use iced_style::slider::{Appearance, Handle, HandleShape, StyleSheet};
 
-/// An horizontal bar and a handle that selects a single value from a range of
-/// values.
+/// A bar and a handle that selects a single value from a range of values.
 ///
-/// A [`Slider`] will try to fill the horizontal space of its container.
+/// A [`Slider`] will try to fill the space of its container, based on its orientation.
 ///
 /// The [`Slider`] range of numeric values is generic and its step size defaults
 /// to 1 unit.
@@ -53,8 +52,9 @@ where
     value: T,
     on_change: Box<dyn Fn(T) -> Message + 'a>,
     on_release: Option<Message>,
-    width: Length,
-    height: u16,
+    width: Option<Length>,
+    height: Option<Length>,
+    orientation: Orientation,
     style: <Renderer::Theme as StyleSheet>::Style,
 }
 
@@ -65,9 +65,6 @@ where
     Renderer: crate::Renderer,
     Renderer::Theme: StyleSheet,
 {
-    /// The default height of a [`Slider`].
-    pub const DEFAULT_HEIGHT: u16 = 22;
-
     /// Creates a new [`Slider`].
     ///
     /// It expects:
@@ -98,8 +95,9 @@ where
             step: T::from(1),
             on_change: Box::new(on_change),
             on_release: None,
-            width: Length::Fill,
-            height: Self::DEFAULT_HEIGHT,
+            width: None,
+            height: None,
+            orientation: Default::default(),
             style: Default::default(),
         }
     }
@@ -117,13 +115,13 @@ where
 
     /// Sets the width of the [`Slider`].
     pub fn width(mut self, width: Length) -> Self {
-        self.width = width;
+        self.width = Some(width);
         self
     }
 
     /// Sets the height of the [`Slider`].
-    pub fn height(mut self, height: u16) -> Self {
-        self.height = height;
+    pub fn height(mut self, height: Length) -> Self {
+        self.height = Some(height);
         self
     }
 
@@ -141,6 +139,12 @@ where
         self.step = step;
         self
     }
+
+    /// Sets the orientation of the [`Slider`].
+    pub fn orientation(mut self, orientation: Orientation) -> Self {
+        self.orientation = orientation;
+        self
+    }
 }
 
 impl<'a, T, Message, Renderer> Widget<Message, Renderer>
@@ -160,11 +164,17 @@ where
     }
 
     fn width(&self) -> Length {
-        self.width
+        match self.orientation {
+            Orientation::Horizontal => self.width.unwrap_or(Length::Fill),
+            Orientation::Vertical => Length::Shrink,
+        }
     }
 
     fn height(&self) -> Length {
-        Length::Shrink
+        match self.orientation {
+            Orientation::Horizontal => Length::Shrink,
+            Orientation::Vertical => self.height.unwrap_or(Length::Fill),
+        }
     }
 
     fn layout(
@@ -172,9 +182,14 @@ where
         _renderer: &Renderer,
         limits: &layout::Limits,
     ) -> layout::Node {
-        let limits =
-            limits.width(self.width).height(Length::Units(self.height));
-
+        let width = self
+            .width
+            .unwrap_or_else(|| self.orientation.default_width());
+        let height = self
+            .height
+            .unwrap_or_else(|| self.orientation.default_height());
+
+        let limits = limits.width(width).height(height);
         let size = limits.resolve(Size::ZERO);
 
         layout::Node::new(size)
@@ -201,6 +216,7 @@ where
             self.step,
             self.on_change.as_ref(),
             &self.on_release,
+            self.orientation,
         )
     }
 
@@ -223,6 +239,7 @@ where
             &self.range,
             theme,
             self.style,
+            self.orientation,
         )
     }
 
@@ -270,6 +287,7 @@ pub fn update<Message, T>(
     step: T,
     on_change: &dyn Fn(T) -> Message,
     on_release: &Option<Message>,
+    orientation: Orientation,
 ) -> event::Status
 where
     T: Copy + Into<f64> + num_traits::FromPrimitive,
@@ -279,17 +297,40 @@ where
 
     let mut change = || {
         let bounds = layout.bounds();
-        let new_value = if cursor_position.x <= bounds.x {
+
+        let cursor_below_bounds = match orientation {
+            Orientation::Horizontal => cursor_position.x <= bounds.x,
+            Orientation::Vertical => {
+                cursor_position.y >= bounds.y + bounds.height
+            }
+        };
+
+        let cursor_above_bounds = match orientation {
+            Orientation::Horizontal => {
+                cursor_position.x >= bounds.x + bounds.width
+            }
+            Orientation::Vertical => cursor_position.y <= bounds.y,
+        };
+
+        let new_value = if cursor_below_bounds {
             *range.start()
-        } else if cursor_position.x >= bounds.x + bounds.width {
+        } else if cursor_above_bounds {
             *range.end()
         } else {
             let step = step.into();
             let start = (*range.start()).into();
             let end = (*range.end()).into();
 
-            let percent = f64::from(cursor_position.x - bounds.x)
-                / f64::from(bounds.width);
+            let percent = match orientation {
+                Orientation::Horizontal => {
+                    f64::from(cursor_position.x - bounds.x)
+                        / f64::from(bounds.width)
+                }
+                Orientation::Vertical => {
+                    1.00 - (f64::from(cursor_position.y - bounds.y)
+                        / f64::from(bounds.height))
+                }
+            };
 
             let steps = (percent * (end - start) / step).round();
             let value = steps * step + start;
@@ -354,6 +395,7 @@ pub fn draw<T, R>(
     range: &RangeInclusive<T>,
     style_sheet: &dyn StyleSheet<Style = <R::Theme as StyleSheet>::Style>,
     style: <R::Theme as StyleSheet>::Style,
+    orientation: Orientation,
 ) where
     T: Into<f64> + Copy,
     R: crate::Renderer,
@@ -370,15 +412,26 @@ pub fn draw<T, R>(
         style_sheet.active(style)
     };
 
-    let rail_y = bounds.y + (bounds.height / 2.0).round();
+    let rail = match orientation {
+        Orientation::Horizontal => bounds.y + (bounds.height / 2.0).round(),
+        Orientation::Vertical => bounds.x + (bounds.width / 2.0).round(),
+    };
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: Rectangle {
-                x: bounds.x,
-                y: rail_y - 1.0,
-                width: bounds.width,
-                height: 2.0,
+            bounds: match orientation {
+                Orientation::Horizontal => Rectangle {
+                    x: bounds.x,
+                    y: rail - 1.0,
+                    width: bounds.width,
+                    height: 2.0,
+                },
+                Orientation::Vertical => Rectangle {
+                    x: rail - 1.0,
+                    y: bounds.y,
+                    width: 2.0,
+                    height: bounds.height,
+                },
             },
             border_radius: 0.0,
             border_width: 0.0,
@@ -389,11 +442,19 @@ pub fn draw<T, R>(
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: Rectangle {
-                x: bounds.x,
-                y: rail_y + 1.0,
-                width: bounds.width,
-                height: 2.0,
+            bounds: match orientation {
+                Orientation::Horizontal => Rectangle {
+                    x: bounds.x,
+                    y: rail + 1.0,
+                    width: bounds.width,
+                    height: 2.0,
+                },
+                Orientation::Vertical => Rectangle {
+                    x: rail + 1.0,
+                    y: bounds.y,
+                    width: 2.0,
+                    height: bounds.height,
+                },
             },
             border_radius: 0.0,
             border_width: 0.0,
@@ -410,7 +471,14 @@ pub fn draw<T, R>(
         HandleShape::Rectangle {
             width,
             border_radius,
-        } => (f32::from(width), bounds.height, border_radius),
+        } => {
+            let handle_height = match orientation {
+                Orientation::Horizontal => bounds.height,
+                Orientation::Vertical => bounds.width,
+            };
+
+            (f32::from(width), handle_height, border_radius)
+        }
     };
 
     let value = value.into() as f32;
@@ -423,17 +491,33 @@ pub fn draw<T, R>(
     let handle_offset = if range_start >= range_end {
         0.0
     } else {
-        bounds.width * (value - range_start) / (range_end - range_start)
-            - handle_width / 2.0
+        match orientation {
+            Orientation::Horizontal => {
+                bounds.width * (value - range_start) / (range_end - range_start)
+                    - handle_width / 2.0
+            }
+            Orientation::Vertical => {
+                bounds.height * (value - range_end) / (range_start - range_end)
+                    - handle_width / 2.0
+            }
+        }
     };
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: Rectangle {
-                x: bounds.x + handle_offset.round(),
-                y: rail_y - handle_height / 2.0,
-                width: handle_width,
-                height: handle_height,
+            bounds: match orientation {
+                Orientation::Horizontal => Rectangle {
+                    x: bounds.x + handle_offset.round(),
+                    y: rail - handle_height / 2.0,
+                    width: handle_width,
+                    height: handle_height,
+                },
+                Orientation::Vertical => Rectangle {
+                    x: rail - (handle_height / 2.0),
+                    y: bounds.y + handle_offset.round(),
+                    width: handle_height,
+                    height: handle_width,
+                },
             },
             border_radius: handle_border_radius,
             border_width: style.handle.border_width,
@@ -473,3 +557,36 @@ impl State {
         State::default()
     }
 }
+
+/// The orientation of a [`Slider`].
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+pub enum Orientation {
+    #[default]
+    /// Default orientation.
+    /// Will fill the horizontal space of its container.
+    Horizontal,
+    /// Vertical orientation.
+    /// Will fill the vertical space of its container.
+    Vertical,
+}
+
+impl Orientation {
+    /// The default height of a [`Slider`] in horizontal orientation.
+    pub const DEFAULT_HEIGHT: Length = Length::Units(22);
+    /// The default width of a [`Slider`] in vertical orientation.
+    pub const DEFAULT_WIDTH: Length = Length::Units(22);
+
+    fn default_height(&self) -> Length {
+        match self {
+            Orientation::Horizontal => Self::DEFAULT_HEIGHT,
+            Orientation::Vertical => Length::Fill,
+        }
+    }
+
+    fn default_width(&self) -> Length {
+        match self {
+            Orientation::Horizontal => Length::Fill,
+            Orientation::Vertical => Self::DEFAULT_WIDTH,
+        }
+    }
+}

From bb4161c1aec0a2a76de39ff2e5ed65f7acbad471 Mon Sep 17 00:00:00 2001
From: Casper Storm <casper.storm@lich.io>
Date: Tue, 13 Dec 2022 10:05:52 +0100
Subject: [PATCH 2/3] Split vertical orientation into VerticalSlider

---
 examples/slider/src/main.rs          |  20 +-
 native/src/widget.rs                 |   3 +
 native/src/widget/helpers.rs         |  17 +
 native/src/widget/slider.rs          | 199 +++---------
 native/src/widget/vertical_slider.rs | 470 +++++++++++++++++++++++++++
 src/widget.rs                        |   2 +
 6 files changed, 540 insertions(+), 171 deletions(-)
 create mode 100644 native/src/widget/vertical_slider.rs

diff --git a/examples/slider/src/main.rs b/examples/slider/src/main.rs
index 4477038209..6286d62581 100644
--- a/examples/slider/src/main.rs
+++ b/examples/slider/src/main.rs
@@ -1,4 +1,4 @@
-use iced::widget::{column, container, slider, text};
+use iced::widget::{column, container, slider, text, vertical_slider};
 use iced::{Element, Length, Sandbox, Settings};
 
 pub fn main() -> iced::Result {
@@ -34,21 +34,15 @@ impl Sandbox for Slider {
     }
 
     fn view(&self) -> Element<Message> {
-        use slider::Orientation::{Horizontal, Vertical};
-
         let value = self.slider_value;
 
-        let h_slider = container(
-            slider(0..=100, value, Message::SliderChanged)
-                .orientation(Horizontal),
-        )
-        .width(Length::Units(250));
+        let h_slider =
+            container(slider(0..=100, value, Message::SliderChanged))
+                .width(Length::Units(250));
 
-        let v_slider = container(
-            slider(0..=100, value, Message::SliderChanged)
-                .orientation(Vertical),
-        )
-        .height(Length::Units(200));
+        let v_slider =
+            container(vertical_slider(0..=100, value, Message::SliderChanged))
+                .height(Length::Units(200));
 
         let text = text(format!("{value}"));
 
diff --git a/native/src/widget.rs b/native/src/widget.rs
index a4b46ed431..efe26fc78e 100644
--- a/native/src/widget.rs
+++ b/native/src/widget.rs
@@ -33,6 +33,7 @@ pub mod text_input;
 pub mod toggler;
 pub mod tooltip;
 pub mod tree;
+pub mod vertical_slider;
 
 mod action;
 mod id;
@@ -79,6 +80,8 @@ pub use toggler::Toggler;
 pub use tooltip::Tooltip;
 #[doc(no_inline)]
 pub use tree::Tree;
+#[doc(no_inline)]
+pub use vertical_slider::VerticalSlider;
 
 pub use action::Action;
 pub use id::Id;
diff --git a/native/src/widget/helpers.rs b/native/src/widget/helpers.rs
index 0bde288fca..8cc1ae8205 100644
--- a/native/src/widget/helpers.rs
+++ b/native/src/widget/helpers.rs
@@ -198,6 +198,23 @@ where
     widget::Slider::new(range, value, on_change)
 }
 
+/// Creates a new [`VerticalSlider`].
+///
+/// [`VerticalSlider`]: widget::VerticalSlider
+pub fn vertical_slider<'a, T, Message, Renderer>(
+    range: std::ops::RangeInclusive<T>,
+    value: T,
+    on_change: impl Fn(T) -> Message + 'a,
+) -> widget::VerticalSlider<'a, T, Message, Renderer>
+where
+    T: Copy + From<u8> + std::cmp::PartialOrd,
+    Message: Clone,
+    Renderer: crate::Renderer,
+    Renderer::Theme: widget::slider::StyleSheet,
+{
+    widget::VerticalSlider::new(range, value, on_change)
+}
+
 /// Creates a new [`PickList`].
 ///
 /// [`PickList`]: widget::PickList
diff --git a/native/src/widget/slider.rs b/native/src/widget/slider.rs
index bf3383d9ae..87030a4d09 100644
--- a/native/src/widget/slider.rs
+++ b/native/src/widget/slider.rs
@@ -16,9 +16,10 @@ use std::ops::RangeInclusive;
 
 pub use iced_style::slider::{Appearance, Handle, HandleShape, StyleSheet};
 
-/// A bar and a handle that selects a single value from a range of values.
+/// An horizontal bar and a handle that selects a single value from a range of
+/// values.
 ///
-/// A [`Slider`] will try to fill the space of its container, based on its orientation.
+/// A [`Slider`] will try to fill the horizontal space of its container.
 ///
 /// The [`Slider`] range of numeric values is generic and its step size defaults
 /// to 1 unit.
@@ -52,9 +53,8 @@ where
     value: T,
     on_change: Box<dyn Fn(T) -> Message + 'a>,
     on_release: Option<Message>,
-    width: Option<Length>,
-    height: Option<Length>,
-    orientation: Orientation,
+    width: Length,
+    height: u16,
     style: <Renderer::Theme as StyleSheet>::Style,
 }
 
@@ -65,6 +65,9 @@ where
     Renderer: crate::Renderer,
     Renderer::Theme: StyleSheet,
 {
+    /// The default height of a [`Slider`].
+    pub const DEFAULT_HEIGHT: u16 = 22;
+
     /// Creates a new [`Slider`].
     ///
     /// It expects:
@@ -95,9 +98,8 @@ where
             step: T::from(1),
             on_change: Box::new(on_change),
             on_release: None,
-            width: None,
-            height: None,
-            orientation: Default::default(),
+            width: Length::Fill,
+            height: Self::DEFAULT_HEIGHT,
             style: Default::default(),
         }
     }
@@ -115,13 +117,13 @@ where
 
     /// Sets the width of the [`Slider`].
     pub fn width(mut self, width: Length) -> Self {
-        self.width = Some(width);
+        self.width = width;
         self
     }
 
     /// Sets the height of the [`Slider`].
-    pub fn height(mut self, height: Length) -> Self {
-        self.height = Some(height);
+    pub fn height(mut self, height: u16) -> Self {
+        self.height = height;
         self
     }
 
@@ -139,12 +141,6 @@ where
         self.step = step;
         self
     }
-
-    /// Sets the orientation of the [`Slider`].
-    pub fn orientation(mut self, orientation: Orientation) -> Self {
-        self.orientation = orientation;
-        self
-    }
 }
 
 impl<'a, T, Message, Renderer> Widget<Message, Renderer>
@@ -164,17 +160,11 @@ where
     }
 
     fn width(&self) -> Length {
-        match self.orientation {
-            Orientation::Horizontal => self.width.unwrap_or(Length::Fill),
-            Orientation::Vertical => Length::Shrink,
-        }
+        self.width
     }
 
     fn height(&self) -> Length {
-        match self.orientation {
-            Orientation::Horizontal => Length::Shrink,
-            Orientation::Vertical => self.height.unwrap_or(Length::Fill),
-        }
+        Length::Shrink
     }
 
     fn layout(
@@ -182,14 +172,9 @@ where
         _renderer: &Renderer,
         limits: &layout::Limits,
     ) -> layout::Node {
-        let width = self
-            .width
-            .unwrap_or_else(|| self.orientation.default_width());
-        let height = self
-            .height
-            .unwrap_or_else(|| self.orientation.default_height());
-
-        let limits = limits.width(width).height(height);
+        let limits =
+            limits.width(self.width).height(Length::Units(self.height));
+
         let size = limits.resolve(Size::ZERO);
 
         layout::Node::new(size)
@@ -216,7 +201,6 @@ where
             self.step,
             self.on_change.as_ref(),
             &self.on_release,
-            self.orientation,
         )
     }
 
@@ -239,7 +223,6 @@ where
             &self.range,
             theme,
             &self.style,
-            self.orientation,
         )
     }
 
@@ -287,7 +270,6 @@ pub fn update<Message, T>(
     step: T,
     on_change: &dyn Fn(T) -> Message,
     on_release: &Option<Message>,
-    orientation: Orientation,
 ) -> event::Status
 where
     T: Copy + Into<f64> + num_traits::FromPrimitive,
@@ -297,40 +279,17 @@ where
 
     let mut change = || {
         let bounds = layout.bounds();
-
-        let cursor_below_bounds = match orientation {
-            Orientation::Horizontal => cursor_position.x <= bounds.x,
-            Orientation::Vertical => {
-                cursor_position.y >= bounds.y + bounds.height
-            }
-        };
-
-        let cursor_above_bounds = match orientation {
-            Orientation::Horizontal => {
-                cursor_position.x >= bounds.x + bounds.width
-            }
-            Orientation::Vertical => cursor_position.y <= bounds.y,
-        };
-
-        let new_value = if cursor_below_bounds {
+        let new_value = if cursor_position.x <= bounds.x {
             *range.start()
-        } else if cursor_above_bounds {
+        } else if cursor_position.x >= bounds.x + bounds.width {
             *range.end()
         } else {
             let step = step.into();
             let start = (*range.start()).into();
             let end = (*range.end()).into();
 
-            let percent = match orientation {
-                Orientation::Horizontal => {
-                    f64::from(cursor_position.x - bounds.x)
-                        / f64::from(bounds.width)
-                }
-                Orientation::Vertical => {
-                    1.00 - (f64::from(cursor_position.y - bounds.y)
-                        / f64::from(bounds.height))
-                }
-            };
+            let percent = f64::from(cursor_position.x - bounds.x)
+                / f64::from(bounds.width);
 
             let steps = (percent * (end - start) / step).round();
             let value = steps * step + start;
@@ -395,7 +354,6 @@ pub fn draw<T, R>(
     range: &RangeInclusive<T>,
     style_sheet: &dyn StyleSheet<Style = <R::Theme as StyleSheet>::Style>,
     style: &<R::Theme as StyleSheet>::Style,
-    orientation: Orientation,
 ) where
     T: Into<f64> + Copy,
     R: crate::Renderer,
@@ -412,26 +370,15 @@ pub fn draw<T, R>(
         style_sheet.active(style)
     };
 
-    let rail = match orientation {
-        Orientation::Horizontal => bounds.y + (bounds.height / 2.0).round(),
-        Orientation::Vertical => bounds.x + (bounds.width / 2.0).round(),
-    };
+    let rail_y = bounds.y + (bounds.height / 2.0).round();
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: match orientation {
-                Orientation::Horizontal => Rectangle {
-                    x: bounds.x,
-                    y: rail - 1.0,
-                    width: bounds.width,
-                    height: 2.0,
-                },
-                Orientation::Vertical => Rectangle {
-                    x: rail - 1.0,
-                    y: bounds.y,
-                    width: 2.0,
-                    height: bounds.height,
-                },
+            bounds: Rectangle {
+                x: bounds.x,
+                y: rail_y - 1.0,
+                width: bounds.width,
+                height: 2.0,
             },
             border_radius: 0.0.into(),
             border_width: 0.0,
@@ -442,19 +389,11 @@ pub fn draw<T, R>(
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: match orientation {
-                Orientation::Horizontal => Rectangle {
-                    x: bounds.x,
-                    y: rail + 1.0,
-                    width: bounds.width,
-                    height: 2.0,
-                },
-                Orientation::Vertical => Rectangle {
-                    x: rail + 1.0,
-                    y: bounds.y,
-                    width: 2.0,
-                    height: bounds.height,
-                },
+            bounds: Rectangle {
+                x: bounds.x,
+                y: rail_y + 1.0,
+                width: bounds.width,
+                height: 2.0,
             },
             border_radius: 0.0.into(),
             border_width: 0.0,
@@ -471,14 +410,7 @@ pub fn draw<T, R>(
         HandleShape::Rectangle {
             width,
             border_radius,
-        } => {
-            let handle_height = match orientation {
-                Orientation::Horizontal => bounds.height,
-                Orientation::Vertical => bounds.width,
-            };
-
-            (f32::from(width), handle_height, border_radius)
-        }
+        } => (f32::from(width), bounds.height, border_radius),
     };
 
     let value = value.into() as f32;
@@ -491,33 +423,17 @@ pub fn draw<T, R>(
     let handle_offset = if range_start >= range_end {
         0.0
     } else {
-        match orientation {
-            Orientation::Horizontal => {
-                bounds.width * (value - range_start) / (range_end - range_start)
-                    - handle_width / 2.0
-            }
-            Orientation::Vertical => {
-                bounds.height * (value - range_end) / (range_start - range_end)
-                    - handle_width / 2.0
-            }
-        }
+        bounds.width * (value - range_start) / (range_end - range_start)
+            - handle_width / 2.0
     };
 
     renderer.fill_quad(
         renderer::Quad {
-            bounds: match orientation {
-                Orientation::Horizontal => Rectangle {
-                    x: bounds.x + handle_offset.round(),
-                    y: rail - handle_height / 2.0,
-                    width: handle_width,
-                    height: handle_height,
-                },
-                Orientation::Vertical => Rectangle {
-                    x: rail - (handle_height / 2.0),
-                    y: bounds.y + handle_offset.round(),
-                    width: handle_height,
-                    height: handle_width,
-                },
+            bounds: Rectangle {
+                x: bounds.x + handle_offset.round(),
+                y: rail_y - handle_height / 2.0,
+                width: handle_width,
+                height: handle_height,
             },
             border_radius: handle_border_radius.into(),
             border_width: style.handle.border_width,
@@ -557,36 +473,3 @@ impl State {
         State::default()
     }
 }
-
-/// The orientation of a [`Slider`].
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
-pub enum Orientation {
-    #[default]
-    /// Default orientation.
-    /// Will fill the horizontal space of its container.
-    Horizontal,
-    /// Vertical orientation.
-    /// Will fill the vertical space of its container.
-    Vertical,
-}
-
-impl Orientation {
-    /// The default height of a [`Slider`] in horizontal orientation.
-    pub const DEFAULT_HEIGHT: Length = Length::Units(22);
-    /// The default width of a [`Slider`] in vertical orientation.
-    pub const DEFAULT_WIDTH: Length = Length::Units(22);
-
-    fn default_height(&self) -> Length {
-        match self {
-            Orientation::Horizontal => Self::DEFAULT_HEIGHT,
-            Orientation::Vertical => Length::Fill,
-        }
-    }
-
-    fn default_width(&self) -> Length {
-        match self {
-            Orientation::Horizontal => Length::Fill,
-            Orientation::Vertical => Self::DEFAULT_WIDTH,
-        }
-    }
-}
diff --git a/native/src/widget/vertical_slider.rs b/native/src/widget/vertical_slider.rs
new file mode 100644
index 0000000000..28e8405ccc
--- /dev/null
+++ b/native/src/widget/vertical_slider.rs
@@ -0,0 +1,470 @@
+//! Display an interactive selector of a single value from a range of values.
+//!
+//! A [`VerticalSlider`] has some local [`State`].
+use std::ops::RangeInclusive;
+
+pub use iced_style::slider::{Appearance, Handle, HandleShape, StyleSheet};
+
+use crate::event::{self, Event};
+use crate::widget::tree::{self, Tree};
+use crate::{
+    layout, mouse, renderer, touch, Background, Clipboard, Color, Element,
+    Layout, Length, Point, Rectangle, Shell, Size, Widget,
+};
+
+/// An vertical bar and a handle that selects a single value from a range of
+/// values.
+///
+/// A [`VerticalSlider`] will try to fill the vertical space of its container.
+///
+/// The [`VerticalSlider`] range of numeric values is generic and its step size defaults
+/// to 1 unit.
+///
+/// # Example
+/// ```
+/// # use iced_native::widget::vertical_slider;
+/// # use iced_native::renderer::Null;
+/// #
+/// # type VerticalSlider<'a, T, Message> = vertical_slider::VerticalSlider<'a, T, Message, Null>;
+/// #
+/// #[derive(Clone)]
+/// pub enum Message {
+///     SliderChanged(f32),
+/// }
+///
+/// let value = 50.0;
+///
+/// VerticalSlider::new(0.0..=100.0, value, Message::SliderChanged);
+/// ```
+#[allow(missing_debug_implementations)]
+pub struct VerticalSlider<'a, T, Message, Renderer>
+where
+    Renderer: crate::Renderer,
+    Renderer::Theme: StyleSheet,
+{
+    range: RangeInclusive<T>,
+    step: T,
+    value: T,
+    on_change: Box<dyn Fn(T) -> Message + 'a>,
+    on_release: Option<Message>,
+    width: u16,
+    height: Length,
+    style: <Renderer::Theme as StyleSheet>::Style,
+}
+
+impl<'a, T, Message, Renderer> VerticalSlider<'a, T, Message, Renderer>
+where
+    T: Copy + From<u8> + std::cmp::PartialOrd,
+    Message: Clone,
+    Renderer: crate::Renderer,
+    Renderer::Theme: StyleSheet,
+{
+    /// The default width of a [`VerticalSlider`].
+    pub const DEFAULT_WIDTH: u16 = 22;
+
+    /// Creates a new [`VerticalSlider`].
+    ///
+    /// It expects:
+    ///   * an inclusive range of possible values
+    ///   * the current value of the [`VerticalSlider`]
+    ///   * a function that will be called when the [`VerticalSlider`] is dragged.
+    ///   It receives the new value of the [`VerticalSlider`] and must produce a
+    ///   `Message`.
+    pub fn new<F>(range: RangeInclusive<T>, value: T, on_change: F) -> Self
+    where
+        F: 'a + Fn(T) -> Message,
+    {
+        let value = if value >= *range.start() {
+            value
+        } else {
+            *range.start()
+        };
+
+        let value = if value <= *range.end() {
+            value
+        } else {
+            *range.end()
+        };
+
+        VerticalSlider {
+            value,
+            range,
+            step: T::from(1),
+            on_change: Box::new(on_change),
+            on_release: None,
+            width: Self::DEFAULT_WIDTH,
+            height: Length::Fill,
+            style: Default::default(),
+        }
+    }
+
+    /// Sets the release message of the [`VerticalSlider`].
+    /// This is called when the mouse is released from the slider.
+    ///
+    /// Typically, the user's interaction with the slider is finished when this message is produced.
+    /// This is useful if you need to spawn a long-running task from the slider's result, where
+    /// the default on_change message could create too many events.
+    pub fn on_release(mut self, on_release: Message) -> Self {
+        self.on_release = Some(on_release);
+        self
+    }
+
+    /// Sets the width of the [`VerticalSlider`].
+    pub fn width(mut self, width: u16) -> Self {
+        self.width = width;
+        self
+    }
+
+    /// Sets the height of the [`VerticalSlider`].
+    pub fn height(mut self, height: Length) -> Self {
+        self.height = height;
+        self
+    }
+
+    /// Sets the style of the [`VerticalSlider`].
+    pub fn style(
+        mut self,
+        style: impl Into<<Renderer::Theme as StyleSheet>::Style>,
+    ) -> Self {
+        self.style = style.into();
+        self
+    }
+
+    /// Sets the step size of the [`VerticalSlider`].
+    pub fn step(mut self, step: T) -> Self {
+        self.step = step;
+        self
+    }
+}
+
+impl<'a, T, Message, Renderer> Widget<Message, Renderer>
+    for VerticalSlider<'a, T, Message, Renderer>
+where
+    T: Copy + Into<f64> + num_traits::FromPrimitive,
+    Message: Clone,
+    Renderer: crate::Renderer,
+    Renderer::Theme: StyleSheet,
+{
+    fn tag(&self) -> tree::Tag {
+        tree::Tag::of::<State>()
+    }
+
+    fn state(&self) -> tree::State {
+        tree::State::new(State::new())
+    }
+
+    fn width(&self) -> Length {
+        Length::Shrink
+    }
+
+    fn height(&self) -> Length {
+        self.height
+    }
+
+    fn layout(
+        &self,
+        _renderer: &Renderer,
+        limits: &layout::Limits,
+    ) -> layout::Node {
+        let limits =
+            limits.width(Length::Units(self.width)).height(self.height);
+
+        let size = limits.resolve(Size::ZERO);
+
+        layout::Node::new(size)
+    }
+
+    fn on_event(
+        &mut self,
+        tree: &mut Tree,
+        event: Event,
+        layout: Layout<'_>,
+        cursor_position: Point,
+        _renderer: &Renderer,
+        _clipboard: &mut dyn Clipboard,
+        shell: &mut Shell<'_, Message>,
+    ) -> event::Status {
+        update(
+            event,
+            layout,
+            cursor_position,
+            shell,
+            tree.state.downcast_mut::<State>(),
+            &mut self.value,
+            &self.range,
+            self.step,
+            self.on_change.as_ref(),
+            &self.on_release,
+        )
+    }
+
+    fn draw(
+        &self,
+        tree: &Tree,
+        renderer: &mut Renderer,
+        theme: &Renderer::Theme,
+        _style: &renderer::Style,
+        layout: Layout<'_>,
+        cursor_position: Point,
+        _viewport: &Rectangle,
+    ) {
+        draw(
+            renderer,
+            layout,
+            cursor_position,
+            tree.state.downcast_ref::<State>(),
+            self.value,
+            &self.range,
+            theme,
+            &self.style,
+        )
+    }
+
+    fn mouse_interaction(
+        &self,
+        tree: &Tree,
+        layout: Layout<'_>,
+        cursor_position: Point,
+        _viewport: &Rectangle,
+        _renderer: &Renderer,
+    ) -> mouse::Interaction {
+        mouse_interaction(
+            layout,
+            cursor_position,
+            tree.state.downcast_ref::<State>(),
+        )
+    }
+}
+
+impl<'a, T, Message, Renderer> From<VerticalSlider<'a, T, Message, Renderer>>
+    for Element<'a, Message, Renderer>
+where
+    T: 'a + Copy + Into<f64> + num_traits::FromPrimitive,
+    Message: 'a + Clone,
+    Renderer: 'a + crate::Renderer,
+    Renderer::Theme: StyleSheet,
+{
+    fn from(
+        slider: VerticalSlider<'a, T, Message, Renderer>,
+    ) -> Element<'a, Message, Renderer> {
+        Element::new(slider)
+    }
+}
+
+/// Processes an [`Event`] and updates the [`State`] of a [`VerticalSlider`]
+/// accordingly.
+pub fn update<Message, T>(
+    event: Event,
+    layout: Layout<'_>,
+    cursor_position: Point,
+    shell: &mut Shell<'_, Message>,
+    state: &mut State,
+    value: &mut T,
+    range: &RangeInclusive<T>,
+    step: T,
+    on_change: &dyn Fn(T) -> Message,
+    on_release: &Option<Message>,
+) -> event::Status
+where
+    T: Copy + Into<f64> + num_traits::FromPrimitive,
+    Message: Clone,
+{
+    let is_dragging = state.is_dragging;
+
+    let mut change = || {
+        let bounds = layout.bounds();
+        let new_value = if cursor_position.y >= bounds.y + bounds.height {
+            *range.start()
+        } else if cursor_position.y <= bounds.y {
+            *range.end()
+        } else {
+            let step = step.into();
+            let start = (*range.start()).into();
+            let end = (*range.end()).into();
+
+            let percent = 1.0
+                - f64::from(cursor_position.y - bounds.y)
+                    / f64::from(bounds.height);
+
+            let steps = (percent * (end - start) / step).round();
+            let value = steps * step + start;
+
+            if let Some(value) = T::from_f64(value) {
+                value
+            } else {
+                return;
+            }
+        };
+
+        if ((*value).into() - new_value.into()).abs() > f64::EPSILON {
+            shell.publish((on_change)(new_value));
+
+            *value = new_value;
+        }
+    };
+
+    match event {
+        Event::Mouse(mouse::Event::ButtonPressed(mouse::Button::Left))
+        | Event::Touch(touch::Event::FingerPressed { .. }) => {
+            if layout.bounds().contains(cursor_position) {
+                change();
+                state.is_dragging = true;
+
+                return event::Status::Captured;
+            }
+        }
+        Event::Mouse(mouse::Event::ButtonReleased(mouse::Button::Left))
+        | Event::Touch(touch::Event::FingerLifted { .. })
+        | Event::Touch(touch::Event::FingerLost { .. }) => {
+            if is_dragging {
+                if let Some(on_release) = on_release.clone() {
+                    shell.publish(on_release);
+                }
+                state.is_dragging = false;
+
+                return event::Status::Captured;
+            }
+        }
+        Event::Mouse(mouse::Event::CursorMoved { .. })
+        | Event::Touch(touch::Event::FingerMoved { .. }) => {
+            if is_dragging {
+                change();
+
+                return event::Status::Captured;
+            }
+        }
+        _ => {}
+    }
+
+    event::Status::Ignored
+}
+
+/// Draws a [`VerticalSlider`].
+pub fn draw<T, R>(
+    renderer: &mut R,
+    layout: Layout<'_>,
+    cursor_position: Point,
+    state: &State,
+    value: T,
+    range: &RangeInclusive<T>,
+    style_sheet: &dyn StyleSheet<Style = <R::Theme as StyleSheet>::Style>,
+    style: &<R::Theme as StyleSheet>::Style,
+) where
+    T: Into<f64> + Copy,
+    R: crate::Renderer,
+    R::Theme: StyleSheet,
+{
+    let bounds = layout.bounds();
+    let is_mouse_over = bounds.contains(cursor_position);
+
+    let style = if state.is_dragging {
+        style_sheet.dragging(style)
+    } else if is_mouse_over {
+        style_sheet.hovered(style)
+    } else {
+        style_sheet.active(style)
+    };
+
+    let rail_x = bounds.x + (bounds.width / 2.0).round();
+
+    renderer.fill_quad(
+        renderer::Quad {
+            bounds: Rectangle {
+                x: rail_x - 1.0,
+                y: bounds.y,
+                width: 2.0,
+                height: bounds.height,
+            },
+            border_radius: 0.0.into(),
+            border_width: 0.0,
+            border_color: Color::TRANSPARENT,
+        },
+        style.rail_colors.0,
+    );
+
+    renderer.fill_quad(
+        renderer::Quad {
+            bounds: Rectangle {
+                x: rail_x + 1.0,
+                y: bounds.y,
+                width: 2.0,
+                height: bounds.height,
+            },
+            border_radius: 0.0.into(),
+            border_width: 0.0,
+            border_color: Color::TRANSPARENT,
+        },
+        Background::Color(style.rail_colors.1),
+    );
+
+    let (handle_width, handle_height, handle_border_radius) = match style
+        .handle
+        .shape
+    {
+        HandleShape::Circle { radius } => (radius * 2.0, radius * 2.0, radius),
+        HandleShape::Rectangle {
+            width,
+            border_radius,
+        } => (f32::from(width), bounds.width, border_radius),
+    };
+
+    let value = value.into() as f32;
+    let (range_start, range_end) = {
+        let (start, end) = range.clone().into_inner();
+
+        (start.into() as f32, end.into() as f32)
+    };
+
+    let handle_offset = if range_start >= range_end {
+        0.0
+    } else {
+        bounds.height * (value - range_end) / (range_start - range_end)
+            - handle_width / 2.0
+    };
+
+    renderer.fill_quad(
+        renderer::Quad {
+            bounds: Rectangle {
+                x: rail_x - (handle_height / 2.0),
+                y: bounds.y + handle_offset.round(),
+                width: handle_height,
+                height: handle_width,
+            },
+            border_radius: handle_border_radius.into(),
+            border_width: style.handle.border_width,
+            border_color: style.handle.border_color,
+        },
+        style.handle.color,
+    );
+}
+
+/// Computes the current [`mouse::Interaction`] of a [`VerticalSlider`].
+pub fn mouse_interaction(
+    layout: Layout<'_>,
+    cursor_position: Point,
+    state: &State,
+) -> mouse::Interaction {
+    let bounds = layout.bounds();
+    let is_mouse_over = bounds.contains(cursor_position);
+
+    if state.is_dragging {
+        mouse::Interaction::Grabbing
+    } else if is_mouse_over {
+        mouse::Interaction::Grab
+    } else {
+        mouse::Interaction::default()
+    }
+}
+
+/// The local state of a [`VerticalSlider`].
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+pub struct State {
+    is_dragging: bool,
+}
+
+impl State {
+    /// Creates a new [`State`].
+    pub fn new() -> State {
+        State::default()
+    }
+}
diff --git a/src/widget.rs b/src/widget.rs
index 526f2b535a..76cea7be6c 100644
--- a/src/widget.rs
+++ b/src/widget.rs
@@ -141,6 +141,7 @@ pub mod tooltip {
 pub use iced_native::widget::progress_bar;
 pub use iced_native::widget::rule;
 pub use iced_native::widget::slider;
+pub use iced_native::widget::vertical_slider;
 pub use iced_native::widget::Space;
 
 pub use button::Button;
@@ -157,6 +158,7 @@ pub use text::Text;
 pub use text_input::TextInput;
 pub use toggler::Toggler;
 pub use tooltip::Tooltip;
+pub use vertical_slider::VerticalSlider;
 
 #[cfg(feature = "canvas")]
 #[cfg_attr(docsrs, doc(cfg(feature = "canvas")))]

From 55f36bc865652009f1c13e3da6f62d55964a10c2 Mon Sep 17 00:00:00 2001
From: Casper Storm <casper.storm@lich.io>
Date: Tue, 13 Dec 2022 10:13:27 +0100
Subject: [PATCH 3/3] updated README for slider example

---
 examples/slider/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/slider/README.md b/examples/slider/README.md
index 0d409dc687..829d828506 100644
--- a/examples/slider/README.md
+++ b/examples/slider/README.md
@@ -1,7 +1,7 @@
 ## Slider
 
-A bar and a handle that selects a single value from a range of values.  
-Can be oriented both vertical and horizontal.
+A `Slider` is a bar and a handle that selects a single value from a range of values.
+There exists both `Slider` and `VerticalSlider` depending on which orientation you need.
 
 <div align="center">
     <img src="sliders.gif">